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

Перечисления представляют фиксированный набор именованных значений. Перечисления помогают сделать ваш код ^MATLAB® и сгенерировали более читаемый код C/C++. Например, сгенерированный код может протестировать равенство с кодом, таким как if (x == Red) вместо того, чтобы использовать strcmp.

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

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

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

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

Можно использовать базовый тип, чтобы управлять размером перечислимого типа в сгенерированном коде 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 к Типам в Сгенерированном коде.

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

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

Операция	Пример	Примечания
оператор присваивания: `=`	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:

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