主要内容

定义数据类

这个例子展示了如何创建Simulink的子类万博1manbetx®数据类。

使用MATLAB®类语法,用于在包中创建数据类。可选地,为数据类分配属性并定义存储类。

使用一个例子来定义数据类

  1. 查看+万博1manbetx SimulinkDemos文件夹中的数据类包matlabroot/工具/模型/ s万博1manbetximdemos / dataclasses(开放)。

    这个包包含预定义的数据类。

  2. 将文件夹复制到要定义数据类的位置。

  3. 重命名文件夹+ mypkg并将其父文件夹添加到MATLAB路径。

  4. 修改数据类定义。

手动定义数据类

  1. 创建包文件夹+ mypkg并将其父文件夹添加到MATLAB路径。

  2. 创建类文件夹@ phase@Signal内部+ mypkg

    请注意

    万博1manbetxSimulink要求在内部定义数据类+包/ @Class文件夹。

  3. @ phase创建一个MATLAB文件Parameter.m打开它进行编辑。

  4. 的子类定义一个数据类万博1manbetx仿真软件。参数使用MATLAB类语法。

    classdef参数<仿真软件。万博1manbetx参数结束% classdef

而不是使用自定义类名参数信号,使用自定义名称命名类文件夹。例如,定义一个类mypkg.myParameter:

  • 的子类定义数据类万博1manbetx仿真软件。参数万博1manbetx仿真软件。信号

    classdefmyParameter <仿万博1manbetx真软件。参数结束% classdef

  • 在类定义中,将构造函数方法命名为myParametermySignal

  • 将包含类定义的类文件夹命名为@myParameter@mySignal

可选:向数据类添加属性

属性结束关键字包含一个属性定义块。

classdef参数<仿真软件。万博1manbetx参数属性不受约束的属性类型Prop1 = [];结束属性(PropertyType =“逻辑标量”) Prop2 = false;结束属性(PropertyType =“字符”) Prop3 ='';结束属性(PropertyType =“字符”,AllowedValues = {“红色”;“绿色”;“蓝”}) Prop4 =“红色”;结束结束% classdef

的子类添加属性万博1manbetx仿真软件。参数,万博1manbetx仿真软件。信号,或万博1manbetx仿真软件。CustomStorageClassAttributes,您可以指定以下属性类型。

属性类型 语法
两倍数量 属性(PropertyType = '双标量')
int32数量 属性(PropertyType = 'int32标量')
逻辑数 属性(PropertyType = '逻辑标量')
特征向量(字符) 属性(PropertyType =“字符”)
允许值的有限集合的字符向量 属性(PropertyType = 'char', AllowedValues = {'a', 'b', 'c'})

如果您使用MATLAB属性验证(参见验证属性值)而不是PropertyType,属性将在类的属性对话框中显示为编辑字段。如果你使用PropertyTypeAllowedValues,则属性对话框显示:

  • 逻辑标量属性的复选框。

  • 字符向量和的下拉菜单AllowedValues

可选:向数据类中添加初始化代码

您可以在数据类中添加构造函数,以便在实例化类时执行初始化活动。添加的构造函数不能要求输入参数。

在这个例子中,构造函数初始化object的值obj基于可选输入参数。

classdef参数<仿真软件。万博1manbetx参数方法函数obj =参数(optionalValue)如果(nargin == 1) obj。值= optionalValue;结束结束结束%的方法结束% classdef

可选:定义存储类

使用setupCoderInfo方法配置CoderInfo对象。然后,创建对useLocalCustomStorageClasses方法,并打开自定义存储类设计器。

  1. 在数据类的构造函数中,调用useLocalCustomStorageClasses方法。

    classdef参数<仿真软件。万博1manbetx参数方法函数setupCoderInfo (obj) useLocalCustomStorageClasses (obj,“mypkg”);obj.CoderInfo.StorageClass =“自定义”;结束结束%的方法结束% classdef
  2. 打开包的自定义存储类设计器。

    cscdesigner (“mypkg”)
  3. 定义存储类。

可选:为存储类定义自定义属性

  1. 创建一个MATLAB文件myCustomAttribs.m打开它进行编辑。将此文件保存到+ mypkg / @myCustomAttribs文件夹,+ mypkg文件夹中是否包含@ phase@Signal文件夹。

  2. 定义的子类万博1manbetx仿真软件。CustomStorageClassAttributes使用MATLAB类语法。例如,考虑一个存储类,它使用原始标识符定义数据,但也为生成的代码中的数据提供了替代名称。

    classdefmyCustomAttribs <仿万博1manbetx真软件。CustomStorageClassAttributes属性(PropertyType =“字符”) AlternateName ='';结束结束% classdef

  3. 的默认实现isAddressable方法确定存储类是否可写。

    classdefmyCustomAttribs <仿万博1manbetx真软件。CustomStorageClassAttributes属性(PropertyType =“逻辑标量”) IsAlternateNameInstanceSpecific = true;结束方法函数retVal = isAddressable(hObj, hCSCDefn, hData) retVal = false;结束结束%的方法结束% classdef
  4. 的默认实现getInstanceSpecificProps方法。

    有关示例,请参见CSCTypeAttributes_FlatStructure.m在文件夹matlabroot、工具箱、仿真软件万博1manbetx\仿真软件\ dataclasses \ +仿真软件\ @CSCTypeAttributes_FlatStructure(开放),CSCTypeAttributes_Unstructed.m在文件夹matlabroot、工具箱、仿真软件万博1manbetx\仿真软件\ dataclasses \ + mpt \ @CSCTypeAttributes_Unstructed(开放)。

    请注意

    这是一个可选的步骤。默认情况下,所有自定义属性都是特定于实例的,可以针对每个数据对象进行修改。但是,您可以限制哪些属性允许是特定于实例的。

  5. 的默认实现getIdentifiersForInstance方法来定义数据类对象的标识符。

    请注意

    在其默认实现中,此方法查询数据对象的名称或标识符,并在生成的代码中使用该标识符。通过覆盖此方法,您可以在生成的代码中控制数据对象的标识符。

    classdefmyCustomAttribs <仿万博1manbetx真软件。CustomStorageClassAttributes属性(PropertyType =“字符”) GetFunction ='';SetFunction ='';结束方法函数retVal = getIdentifiersForInstance (hCSCAttrib,hscdefn, hData, identifier)“GetFunction”,hData.CoderInfo.CustomAttributes.GetFunction,“SetFunction”, hData.CoderInfo.CustomAttributes.SetFunction);结束%结束%的方法结束% classdef
  6. 如果您正在使用分组存储类,请重写getIdentifiersForGroup方法以在生成的代码中指定组的标识符。

    例如,请参见CSCTypeAttributes_FlatStructure.m在文件夹matlabroot、工具箱、仿真软件万博1manbetx\仿真软件\ dataclasses \ +仿真软件\ @CSCTypeAttributes_FlatStructure(开放)。

相关的话题