Генерация кода для перечислений

Перечисления представляют фиксированный набор именованных значений. Перечисления помогают сделать ваш код MATLAB^® более читаемым.

Для генерации кода, когда вы используете перечисления, придерживаются этих ограничений:

Вызовы методов классов перечисления не поддерживаются.
Передача строк или векторов символов конструкторам перечислений не поддерживается.
Класс перечисления должен вывести из одного из этих базовых типов: int8uint8int16uint16, или int32. Смотрите задают перечисления для генерации кода.
Можно использовать только ограниченный набор операций на перечислениях. Смотрите Позволенные Операции на Перечислениях.
Используйте перечисления с функциями, которые поддерживают перечислимые типы для генерации кода. Смотрите Функции Тулбокса MATLAB Та Поддержка Перечисления.

Задайте перечисления для генерации кода

Для генерации кода класс перечисления должен вывести из одного из этих базовых типов: int8uint8int16uint16, или int32. Например:

classdef PrimaryColors < int32
    enumeration
        Red(1),
        Blue(2),
        Yellow(4)
    end
end

Если вы используете MATLAB Coder™, чтобы сгенерировать код C/C++, можно использовать базовый тип, чтобы управлять размером перечислимого типа в сгенерированном коде. Вы можете:

Представляйте перечислимый тип как целое число фиксированного размера, которое портативно к различным целям.
Уменьшайте использование памяти.
Интерфейс с унаследованным кодом.
Совпадайте со стандартами компании.

Представление перечислимого типа в сгенерированном коде

Базовый тип определяет представление перечислимого типа в сгенерированном коде C/C++.

Если базовый тип является нативным целочисленным типом для целевой платформы (например, int32), генератор кода производит перечислимый тип C/C++. Рассмотрите это определение перечислимого типа MATLAB:

classdef LEDcolor < int32
    enumeration
        GREEN(1),
        RED(2)
    end
end

Это определение перечислимого типа приводит к следующему коду C/C++:

enum LEDcolor
{
    GREEN = 1,
    RED
};

typedef enum LEDcolor LEDcolor;

Для встроенных целочисленных базовых типов, которые отличаются от нативного целочисленного типа для целевой платформы:

Если вы генерируете код С, генератор кода производит typedef оператор для перечислимого типа и #define операторы для перечисляемых значений. Рассмотрите это определение перечислимого типа MATLAB:
```
classdef LEDcolor < int16
    enumeration
        GREEN(1),
        RED(2)
    end
    
end
```
Определение перечислимого типа производит этот код С:
```
typedef short LEDcolor;
#define GREEN ((LEDcolor)1)
#define RED ((LEDcolor)2)
```
Если вы генерируете Код С++, члены перечисления преобразованы в константы. Эти константы принадлежат пространству имен, которое содержит определение перечисляемого типа в сгенерированном Коде С++.
Например, предположите, что вы помещаете это определение перечислимого типа MATLAB в пакете pkg:
```
classdef LEDcolor < int16
    enumeration
        GREEN(1),
        RED(2)
    end
    
end
```
Поведение по умолчанию генератора кода должно преобразовать пакеты MATLAB в пространства имен C++. Сгенерированный Код С++ помещается в пространстве имен pkg:
```
namespace pkg {
typedef short LEDcolor;

// enum pkg_LEDcolor
const LEDcolor GREEN{1};
const LEDcolor RED{2};

}
```

Тип C/C++ в typedef оператор зависит от:

Целочисленные размеры, заданные для производственного оборудования в аппаратной реализации, возражают или настройки проекта. Смотрите coder.HardwareImplementation (MATLAB Coder).
Установка, которая определяет использование встроенных типов C или определения типов MathWorks^® в сгенерированном коде. Смотрите Задают Типы данных, Используемые в Сгенерированном коде (MATLAB Coder) и Отображение Типы MATLAB к Типам в Сгенерированном коде (MATLAB Coder).

Позволенные операции на перечислениях

Для генерации кода вы ограничиваетесь операциями на перечислениях, перечисленных в этой таблице.

Операция	Пример	Примечания
оператор присваивания: `=`	xon = LEDcolor.GREEN xoff = LEDcolor.RED	—
операторы отношения: `< > <= >= == ~=`	xon == xoff	Генерация кода не поддерживает использование `==` или `~=` протестировать равенство между членом перечисления и массивом строк, символьным массивом или массивом ячеек символьных массивов.
бросьте операцию	double(LEDcolor.RED)	—
преобразование в символьный массив или строку	y = char(LEDcolor.RED); y1 = cast(LEDcolor.RED,'char'); y2 = string(LEDcolor.RED);	Можно преобразовать только оцененные перечисления скаляра времени компиляции. Например, этот код запускается в MATLAB, но производит ошибку в генерации кода: y2 = string(repmat(LEDcolor.RED,1,2)); Генератор кода сохраняет имена перечисления, когда входные параметры преобразования являются константами. Например, рассмотрите это определение перечислимого типа: classdef AnEnum < int32 enumeration zero(0), two(2), otherTwo(2) end end Сгенерированный код производит `"two"` для y = string(AnEnum.two) и `"otherTwo"` для y = string(AnEnum.otherTwo)
индексация операции	m = [1 2] n = LEDcolor(m) p = n(LEDcolor.GREEN)	—
операторы управления: если, переключатель, в то время как	if state == sysMode.ON led = LEDcolor.GREEN; else led = LEDcolor.RED; end	—

Функции тулбокса MATLAB та поддержка перечисления

Для генерации кода можно использовать перечисления с этими функциями тулбокса MATLAB:

Документация