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

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

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

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

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

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

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

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

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

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

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

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

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

enum LEDcolor
{
    GREEN = 1,
    RED
};

typedef enum LEDcolor LEDcolor;

Для встроенных целочисленных базовых типов кроме int32 генератор кода производит оператор typedef для перечислимого типа и операторы #define для перечисляемых значений. Рассмотрите это определение перечислимого типа MATLAB:

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

Определение перечислимого типа приводит к этому коду С:

typedef short LEDcolor;
#define GREEN ((LEDcolor)1)
#define RED ((LEDcolor)2)

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

Целочисленные размеры, заданные для производственного оборудования в аппаратной реализации, возражают или настройки проекта. Смотрите coder.HardwareImplementation.
Установка, которая определяет использование встроенных типов 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:

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