Main Content

Simulink.AliasType

为信号和参数数据类型创建别名

说明

使用 Simulink.AliasType 创建内置数据类型(例如 int8)的别名。

该对象的名称是别名。别名引用的数据类型(如 int8)是基类型。别名不能为:

  • 内置数据类型,包括:

    • 浮点类型:halfsingledouble

    • 整数类型:int8uint8int16uint16int32uint32int64uint64

    • string

  • sfixufixflt 开头的 Fixed-Point Designer™ 类型。

  • boolean

您在基础工作区或数据字典中创建该对象。要使用别名,请您使用该对象的名称为模型中的信号、状态和参数设置数据类型。

使用别名指定信号和参数数据类型可以极大地简化对模型指定的数据类型进行的全局更改。特别是,更改其数据类型由别名指定的所有信号、状态和参数的数据类型时,仅需更改别名的基类型即可。相比较而言,如果更改其数据类型由实际类型名称指定的信号、状态和参数的数据类型,则需要逐项指定每个信号和参数的数据类型。

您可以使用此类的对象为下列各项创建别名:Simulink® 内置数据类型、定点数据类型、枚举数据类型、Simulink.NumericType 对象以及其他 Simulink.AliasType 对象。只有在您使用基于 ERT 的系统目标文件 (Embedded Coder®) 时,您从模型 (Simulink Coder™) 生成的代码才会使用别名。

或者,要定义和命名数值数据类型,可以使用 Simulink.NumericType 类的对象。

创建对象

您可以通过多种方式创建 Simulink.AliasType 对象。

注意

您必须在 MATLAB® 工作区或数据字典中创建数据类型别名。您无法在模型工作区中创建别名。

描述

示例

aliasObj = Simulink.AliasType 返回具有默认属性值的 Simulink.AliasType 对象。

示例

aliasObj = Simulink.AliasType(baseType) 返回 Simulink.AliasType 对象并使用 baseType 初始化 BaseType 属性的值。

属性

全部展开

要以交互方式编辑 Simulink.AliasType 对象的属性,请使用类型编辑器

此别名重命名的基本数据类型的名称,指定为字符向量或字符串标量。您可以指定一种标准数据类型的名称,例如 int8half,或一种自定义数据类型的名称,例如另一个 Simulink.AliasType 对象的名称或枚举的名称。

要指定定点数据类型,可以调用 fixdt 函数,例如 'fixdt(0,16,7)'。要以交互方式指定类型的特征,请展开数据类型助手,并将模式设置为定点。有关使用数据类型助手的信息,请参阅使用数据类型助手指定数据类型

您可以通过指定一种非标准数据类型(例如 Simulink.NumericType 对象定义的一种数据类型)的名称来指定一种非标准数据类型,但存在一个例外。这个例外是 Simulink.NumericType 对象,其 DataTypeMode定点: 未指定的定标

注意

定点: 未指定的定标是一种部分指定的类型,其定义由使用 Simulink.NumericType 对象的模块完成。禁止在别名类型中使用它,则可避免创建因具体使用位置不同而具有不同基类型的别名。

示例: 'int8'

示例: 'myOtherAlias'

数据类型: char | string

指定是在生成代码 (Simulink Coder) 中生成类型定义还是导入类型定义 (typedef),指定为 'Auto''Exported'Imported'

下表说明了每个选项的影响。

操作
'Auto'(默认值)

如果没有为 HeaderFile 指定任何值,则将类型定义导出到 model_types.h,其中 model 是模型名称。如果您拥有 Embedded Coder 许可证,并且您已指定数据类型替代,则将类型定义导出到 rtwtypes.h

如果为 HeaderFile 指定了值,则从指定的头文件中导入数据类型定义。

'Exported'将数据类型定义导出到头文件中,该文件可在 HeaderFile 属性中指定。如果没有为 HeaderFile 指定任何值,则头文件名称的默认值为 type.htype 是数据类型名称。
'Imported'从头文件中导入数据类型定义,该文件可在 HeaderFile 属性中指定。如果没有为 HeaderFile 指定任何值,则头文件名称的默认值为 type.htype 是数据类型名称。

将数据作用域设置为已导入已导出以避免潜在的 MISRA C:2012 违规。

有关详细信息,请参阅Control File Placement of Custom Data Types (Embedded Coder)

数据类型别名的自定义描述,指定为字符向量。

示例: 'This type alias corresponds to a floating-point implementation.'

数据类型: char

在生成的代码中包含类型定义 (typedef) 的头文件的名称,指定为字符向量。

如果指定了此属性,则在导入或导出的代码生成过程中使用指定的名称。如果此属性为空,则当 DataScope'Imported''Exported' 时默认值为 type.h,当 DataScope'Auto' 时默认值为 model_types.h

默认情况下,生成的 #include 指令使用预处理器分隔符 ",而不是 <>。要生成指令 #include <myTypes.h>,请将 HeaderFile 指定为 '<myTypes.h>'

有关详细信息,请参阅Control File Placement of Custom Data Types (Embedded Coder)

对应于属性对话框中的头文件

示例: 'myHdr.h'

示例: 'myHdr'

示例: 'myHdr.hpp'

数据类型: char

示例

全部折叠

SlDemoSign 枚举类型创建别名:

myEnumAlias = Simulink.AliasType('Enum: SlDemoSign');

要使用 Simulink.AliasType 对象为定点数据类型创建别名,请通过调用 fixdt 函数来设置该对象的 BaseType 属性。必须将 BaseType 的值指定为字符向量。

例如,以下代码为字长等于 16、小数长度等于 7 的无符号定点数据类型创建别名。

myFixptAlias = Simulink.AliasType;
myFixptAlias.BaseType = 'fixdt(0,16,7)';

扩展功能

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

在 R2006a 之前推出