为MATLAB生成高效的独立代码®类,您必须使用不同于在MATLAB环境中运行代码的类。
有什么不同 | 更多的信息 |
---|---|
语言特征的限制集。 | 语言的限制 |
代码生成特性的限制集。 | 代码生成特性与类不兼容 |
类属性的定义。 | 为代码生成定义类属性 |
句柄类的使用。 | |
代码生成不支持包含MATLAB句柄对象的全局变量。万博1manbetx | N/A |
不支持从内置MATLAB类继承。万博1manbetx | 不支持从内置MATLAB类继承万博1manbetx |
虽然提供了代码生成支持类的公共特性,如属性和方法,万博1manbetx但有一些高级特性不受支持,如:
事件
听众
对象的数组
递归数据结构
链表
树
图
构造函数中的嵌套函数
Overloadable运营商subsref
,subsassign
,subsindex
在MATLAB中,类可以定义自己版本的subsref
,subsassign
,subsindex
方法。代码生成不支持对这些方法有自己定义的类。万博1manbetx
的空
方法
在MATLAB中,类有一个内置的静态方法,空
,它创建类的空数组。代码生成不支持此方法。万博1manbetx
下面的MATLAB句柄类方法:
addlistener
情商
findobj
findpro
的AbortSet
属性的属性
您可以为使用类的入口点MATLAB函数生成代码,但不能直接为MATLAB类生成代码。
例如,如果ClassNameA
是类定义,不能通过执行以下命令生成代码:
codegen ClassNameA
句柄类对象不能是入口点函数的输入或输出。
值类对象可以是入口点函数的输入或输出。但是,如果值类对象包含句柄类对象,则值类对象不能作为入口点函数输入或输出。句柄类对象不能是入口点函数的输入或输出。
代码生成不支持处理类的全局变量。万博1manbetx
代码生成不支持将值类的对象分配到不可调优属性。万博1manbetx例如,obj.prop = v;
时是无效的道具
是不可调优的属性和v
是基于值类的对象。
你不能使用coder.extrinsic
将一个类或方法声明为外部的。
你不能将MATLAB类传递给coder.ceval
.可以将类属性传递给coder.ceval
.
如果属性具有get方法、set方法或验证器,或者是具有某些属性的System对象™属性,则不能通过引用将属性传递给外部函数。看到某些属性不支持通过引用传递万博1manbetx.
如果一个对象具有重复的属性名,而代码生成器试图对该对象进行常量折叠,则代码生成可能会失败。当使用对象时,代码生成器常量折叠对象编码器。常数
或coder.const
,或者当它是常数折叠的外部函数的输入或输出时。
在以下情况下,子类的对象中会出现重复的属性名:
子类有一个与超类的属性同名的属性。
子类派生自多个对属性使用相同名称的超类。
有关MATLAB何时允许重复属性名的信息,请参见子类化多个类.
对于代码生成,你必须定义不同于在MATLAB环境中运行代码的类属性:
MEX函数报告由于属性验证而导致的错误。只有启用运行时错误报告功能,独立的C/ c++代码才会报告这些错误。看到生成检测和报告运行时错误的独立C/ c++代码.在生成独立的C/ c++代码之前,最好的做法是在整个输入值范围内运行MEX函数来测试属性验证。
定义属性后,不要给它分配不兼容的类型。在尝试增加属性之前,不要使用它。
在为代码生成定义类属性时,请考虑与定义变量时相同的因素。在MATLAB语言中,变量可以在运行时动态地改变它们的类、大小或复杂性,因此您可以使用相同的变量来保存不同的类、大小或复杂性的值。C和c++使用静态类型。在使用变量之前,为了确定它们的类型,代码生成器需要对每个变量进行完整的赋值。类似地,在使用属性之前,必须显式定义它们的类、大小和复杂性。
初始值:
如果该属性没有显式的初始值,则代码生成器会假定该属性在构造函数的开始处为未定义。代码生成器不会将空矩阵作为默认值。
如果该属性没有初始值,并且代码生成器不能确定该属性在第一次使用之前被分配,则软件将生成编译错误。
对于System对象,如果不可调优属性是一个结构,则必须完全分配该结构。不能使用下标进行部分赋值。
例如,对于不可调优属性,可以使用以下赋值:
mySystemObject.nonTunableProperty =结构(‘基坑’,‘‘,‘fieldB’,' b ');
不能使用以下部分赋值:
mySystemObject.nonTunableProperty.fieldA = ' a ';mySystemObject.nonTunableProperty.fieldB = ' b ';
coder.varsize
类属性不支持。万博1manbetx
如果一个属性的初始值是一个对象,那么该属性必须是常量。要使属性常量,请声明常数
属性块中的属性。例如:
classdefMyClass属性(常量)p1 = MyClass2;结束结束
MATLAB在代码生成之前的类加载时间计算类的初始值。如果在MATLAB类属性初始化中使用持久变量,则类加载时计算的持久变量的值属于MATLAB;它不是代码生成时使用的值。如果你使用coder.target
在MATLAB类属性初始化中,coder.target (MATLAB)
返回真正的(1)
.
适应可变属性:
代码生成支持值类和句柄类的上界和万博1manbetx无界变量大小属性。
要生成无界的可变大小的类属性,请启用动态内存分配。
要创建可变大小的类属性,请对类属性进行两次顺序赋值,一次赋值给标量,另一次赋值给数组。
classdefvarSizeProp1 <处理属性道具varProp结束结束
函数extFunc(n) obj = varSizeProp1;%为属性指定标量值。obj.prop= 1; obj.varProp = 1;将数组赋给相同的属性,使其具有可变大小。obj.prop= 1:98; obj.varProp = 1:n;结束
在前面的代码中,第一个赋值道具
和varProp
是标量,它们的第二个赋值是对具有相同基类型的数组。的大小道具
的上界是98
,使它成为一个有上限的、大小可变的属性。
如果n
在编译时是未知的,obj.varProp
是一个无界的变量大小属性。如果它是已知的,则它是一个有上界的、大小可变的类属性。
如果类属性是用可变大小数组初始化的,则该属性是可变大小的。
classdefvarSizeProp2属性道具结束方法函数obj = varSizeProp2(不胀钢)将传入值赋给本地变量locVar =不胀钢;%声明局部变量为变量大小的列没有大小限制的%向量coder.varsize (“locVar”[正1],[1 0]);%分配值obj.prop= locVar;结束结束结束
在上述代码中,不胀钢
传递给类构造函数并存储在locVar
.locVar
被修改为可变大小coder.varsize
并分配给班级财产obj.prop
,这使得属性变量为size。
如果是函数调用的输入varSizeProp2
适应,coder.varsize
不是必需的。
函数z = structcall (n) z = varSizeProp2(1:n);结束
如果n
在编译时是未知的,并且没有指定的边界,z.prop
是一个无界的变量大小的类属性。
如果n
在编译时是未知的,并具有指定的边界,z.prop
是一个上界变量大小的类属性。
如果属性是常量且其值是对象,则不能更改该对象的属性值。例如,假设:
obj
是…的对象myClass1
.
myClass1
具有常数性质p1
那是一个对象myClass2
.
myClass2
有一个属性p2
.
代码生成不支持以下代码:万博1manbetx
obj.p1。p2 = 1;
不能为继承内置MATLAB类的类生成代码。例如,您不能为以下类生成代码:
classdefmyclass <双