Simulink.defineIntEnumType

Define enumerated data type

Syntax

Simulink.defineIntEnumType(ClassName, CellOfEnums,IntValues)

Simulink.defineIntEnumType(___,'Description',ClassDesc)

Simulink.defineIntEnumType(___,'DefaultValue',DefValue)

Simulink.defineIntEnumType(___,'DataScope',ScopeSelection)

Simulink.defineIntEnumType(___,'HeaderFile',FileName)

Simulink.defineIntEnumType(___,'AddClassNameToEnumNames',Flag)

Simulink.defineIntEnumType(___,'StorageType',DataType)

Description

Simulink.defineIntEnumType(ClassName, CellOfEnums,IntValues) defines an enumeration named ClassName with enumeration values specified with CellOfEnums and underlying numeric values specified by IntValues.

Simulink.defineIntEnumType(___,'Description',ClassDesc) defines the enumeration with a description.

Simulink.defineIntEnumType(___,'DefaultValue',DefValue) defines a default value for the enumeration, which is one of the character vectors you specify for CellOfEnums.

Simulink.defineIntEnumType(___,'DataScope',ScopeSelection) specifies whether the data type definition should be imported from, or exported to, a header file during code generation.

Simulink.defineIntEnumType(___,'HeaderFile',FileName) specifies the name of a header file containing the enumeration class definition for use in code generated from a model.

Simulink.defineIntEnumType(___,'AddClassNameToEnumNames',Flag) specifies whether the code generator applies the class name as a prefix to the enumeration values that you specify for CellOfEnums. For Flag, specify true or false. For example, if you specify true, the code generator would use BasicColors_Red instead of Red to represent an enumerated value.

Simulink.defineIntEnumType(___,'StorageType',DataType) specifies the data type used to store the enumerations’ underlying integer values in code generated from a model.

Examples

Import Enumeration Class Definition Into Workspace

Assume an external data dictionary includes the following enumeration:

BasicColors.Red(0), BasicColors.Yellow(1), BasicColors.Blue(2)

Import the enumeration class definition into the MATLAB^® workspace while specifying int16 as the underlying integer data type for generated code:

Simulink.defineIntEnumType('BasicColors', ... 
	{'Red', 'Yellow', 'Blue'}, ...
	[0;1;2], ... 
	'Description', 'Basic colors', ...
	'DefaultValue', 'Blue', ...
	'HeaderFile', 'mybasiccolors.h', ...
	'DataScope', 'Exported', ...
	'AddClassNameToEnumNames', true, ...
	'StorageType', 'int16');

Input Arguments

ClassName — Name of enumerated data type

character vector | string

The name of the enumerated data type, specified as a character vector or string.

Example: 'BasicColors'

CellOfEnums — Enumerations for data type

cell array of character vectors

Enumerations for the data type, specified as a cell array of character vectors.

Example: {'Red', 'Yellow', 'Blue'}

IntValues — Numeric enumeration values

array of numeric values

Numeric enumeration values, specified as an array. For uint32-based enumerations, enumeration values must be less than or equal to intmax('int32').

Example: [0;1;2]

ClassDesc — Description of enumeration data type

character vector

Description of the enumeration data type, specified as a character vector.

Example: 'Basic colors'

DefValue — Default enumeration value

character vector

The default enumeration value, specified as a character vector. The value is one of the character vectors specified for CellOfEnums.

Example: 'Blue'

FileName — Header file

character vector

That header file that is to contain the data type definition, specified as a character vector. By default, the generated #include directive uses the preprocessor delimiter " instead of < and >. To generate the directive #include <mytypes.h>, specify FileName as '<myTypes.h>'.

Example: 'mybasiccolors.h'

ScopeSelection — Action for data type definition

'Auto' (default) | 'Exported' | 'Imported'

Action to take for the data type definition during code generation , specified as one of these values:

• 'Auto' — If no value is specified for HeaderFile, export the type definition to model_types.h where model is the model name. If a value is specified for HeaderFile, import the data type definition from the specified header file.

• 'Exported' — Export the data type definition to a header file. If no value is specified for HeaderFile, the header file name defaults to type.h, where type is the data type name.

• 'Imported' — Import the data type definition from a header file. If no value is specified for HeaderFile, the header file name defaults to type.h, where type is the data type name.

Set the data scope selection to Imported or Exported to avoid potential MISRA C:2012 violations.

Flag — Whether class name is a prefix to enumeration

false or 0 (default) | true or 1

Whether the code generator applies the class name as a prefix to the enumerations, specified as a numeric or logical 1 (true) or 0 (false).

Example: true

DataType — Data type used to store enumeration values

'int8' | 'int16' | 'int32' | 'uint8' | 'uint16' | 'uint32'

Data type used to store the enumerations' underlying integer values in generated code, specified as a character vector.

Example: 'int16'

Version History

Introduced in R2010b