coder.cstructname

在生成的代码中命名C结构类型

在页面中全部折叠

语法

structName coder.cstructname (var)

structName coder.cstructname (var,“外来的”,“HeaderFile”,HeaderFile)

structName coder.cstructname (var,“外来的”,“HeaderFile”,HeaderFile,对齐,对齐)

outtype = code .cstructname(intype,structName)

outtype = code .cstructname(intype,structName，'extern'，'HeaderFile'， HeaderFile)

outtype = code .cstructname(intype,structName，'extern'，'HeaderFile'， HeaderFile，'Alignment'， Alignment)

描述

coder.cstructname命名生成的或外部定义的用于MATLAB的C结构类型^®在生成的代码中表示为结构的变量。

例子

coder.cstructname (var，structName）命名为MATLAB变量生成的C结构类型var．输入var可以是一个结构或单元格数组。在生成代码的函数中使用此语法。的地方coder.cstructname在定义之后var而在第一次使用之前var．如果var入口点(顶层)函数输入参数是place吗coder.cstructname在函数的开始，在任何控制流语句之前。

例子

coder.cstructname (var，structName“外来的”,“HeaderFile”,headerfile）指定要使用的C结构类型var有名字structName并在外部文件中定义，headerfileName．

可以使用“外来的”选项，而不指定头文件。但是，最佳实践是指定头文件，以便代码生成器生成# include语句在正确的位置。

coder.cstructname (var，structName“外来的”,“HeaderFile”,headerfile“对齐”,对齐）还指定外部定义的结构类型的运行时内存对齐方式structName．如果你有嵌入式编码器^®并使用自定义代码替换库(CRLs)，指定对齐方式，以便代码生成器能够匹配需要对齐结构的CRL函数。看到代码替换的数据对齐(嵌入式编码)。

例子

outtype= coder.cstructname (intype，structName）返回结构或单元格数组类型对象outtype指定要生成的C结构类型的名称。coder.cstructname创建outtype使用输入类型的属性intype．然后，它设置TypeName财产structName．类使用此语法创建类型对象codegenarg游戏选择。不能在从中生成代码的函数中使用此语法。

中不能使用此语法MATLAB函数块。

outtype= coder.cstructname (intype，structName“外来的”,“HeaderFile”,headerfile）返回一个类型对象outtype指定外部定义的C结构类型的名称和位置。代码生成器为具有类型的变量使用外部定义的结构类型outtype．

中不能使用此语法MATLAB函数块。

outtype= coder.cstructname (intype，structName“外来的”,“HeaderFile”,headerfile“对齐”,对齐）创建一个类型对象outtype它还指定了C结构类型对齐。

中不能使用此语法MATLAB函数块。

例子

全部折叠

为函数中的变量命名C结构类型

在MATLAB函数中，myfun，分配名称MyStruct为变量生成的C结构类型v．

函数Y = myfun()% # codegenV = struct(“一个”, 1“b”2);coder.cstructname (v,“myStruct”）;Y = v;结束

生成独立的C代码。例如，生成一个静态库。

codegen配置:自由myfun报告

要查看生成的结构类型，请打开codegen / lib / myfun / myfun_types.h或视图myfun_types.h在代码生成报告中。生成的C结构类型为:

Typedef结构{double a;双b;} myStruct;

命名子结构生成的C结构类型

在MATLAB函数中，myfun1，分配名称MyStruct为该结构生成的C结构类型v．分配名称mysubStruct到为子结构生成的结构类型v.b．

函数Y = myfun()% # codegenV = struct(“一个”, 1“b”结构(“f”3));coder.cstructname (v,“myStruct”）;coder.cstructname (v.b“mysubStruct”）;Y = v;结束

生成的C结构类型mysubStruct是:

Typedef结构{double f;} mysubStruct;

生成的C结构类型myStruct是:

Typedef结构{double a;mysubStruct b;} myStruct;

命名为单元格数组生成的结构类型

在MATLAB函数中，myfun2，分配名称myStruct为单元格数组生成的C结构类型c．

函数Z = myfun2() c = {1 2 3};coder.cstructname (c,“myStruct”) z = c;

生成的C结构类型c是:

Typedef结构{double f1;双f2;双f3;} myStruct;

命名一个外部定义的C结构类型

指定传递给C函数的结构具有在C头文件中定义的结构类型。

创建一个C头文件mycadd.h对于函数mycadd它接受类型形参mycstruct．定义类型mycstruct在头文件中。

#定义MYCADD_H类型定义结构{double f1;双f2;} mycstruct;mycadd(mycstruct *s);# endif

编写C函数mycadd.c．

#include  #include  #include "mycadd.h" double mycadd(mycstruct *s) {return s->f1 + s->f2;｝

写一个MATLAB函数mymAdd通过引用传递结构的mycadd．使用coder.cstructname来指定在生成的代码中，该结构具有C类型mycstruct中定义mycadd.h．

函数y = mymAdd% # codegenS = struct(“f1”, 1“f2”2);coder.cstructname(年代,“mycstruct”，“外来的”，“HeaderFile”，“mycadd.h”）;Y = 0;Y = code .ceval(“mycadd”coder.ref (s));

为函数生成一个C静态库mymAdd．

codegen配置:自由mymAddmycadd.c

生成的头文件mymadd_types.h不包含结构的定义mycstruct因为mycstruct是一个外部类型。

创建一个命名生成的C结构类型的结构类型对象

假设入口点函数myFunction需要一个结构参数。在命令行中指定输入参数的类型:

定义一个示例结构年代．
创建一个类型T从年代通过使用coder.typeof．
使用coder.cstructname要创建一个类型T1:
- 具有T．
- 命名生成的C结构类型myStruct．
将类型传递给codegen通过使用arg游戏选择。

例如:

S = struct(“一个”、双(0)“b”单(0));T = code .typeof(S);T1 = code .cstructname(“myStruct”）;codegen配置:自由myFunctionarg游戏T1

或者，您可以直接从示例结构创建结构类型。

S = struct(“一个”、双(0)“b”单(0));T1 = code .cstructname(S，“myStruct”）;codegen配置:自由myFunctionarg游戏T1

输入参数

全部折叠

`var`- - - - - -MATLAB结构或单元格数组变量
结构|单元阵列

MATLAB结构或单元格数组变量，在生成的代码中表示为结构。

`structName`- - - - - -C结构类型名称
特征向量|字符串标量

生成的或外部定义的C结构类型的名称，指定为字符向量或字符串标量。

`headerfile`- - - - - -包含C结构类型定义的头文件
特征向量|字符串标量

包含C结构类型定义的头文件，指定为字符向量或字符串标量。

指定文件的路径。

使用codegen-我选项或附加包含目录参数。MATLAB编码器™应用程序设置自定义代码选项卡。
对于一个MATLAB函数Block，在模拟目标和代码生成>自定义代码窗格,在其他构建信息，设置包括目录参数。

另外,使用coder.updateBuildInfo与“addIncludePaths”选择。

例子:“mystruct.h”

`对齐`- - - - - -结构的运行时内存对齐
－1(默认)|的力量`2`不大于`128`

生成的或外部定义的结构的运行时内存对齐。

`intype`- - - - - -类型对象或变量，用于创建新的类型对象
`编码器。年代tructType`|`编码器。CellType`|结构|单元阵列

可以从中创建类型对象的结构类型对象、单元格数组类型对象、结构变量或单元格数组变量。

限制

你不能申请coder.cstructname直接到全局变量。若要命名要与全局变量一起使用的结构类型，请使用coder.cstructname创建命名结构类型的类型对象。然后，当你跑步时codegen，指定全局变量具有该类型。看到将C结构类型命名为与全局结构变量一起使用(MATLAB编码器)。
对于单元格数组输入，外部定义的结构的字段名必须为f1，f2，等等。

提示

有关代码生成器如何确定结构字段的C/ c++类型的信息，请参见将MATLAB类型映射到生成代码中的类型(MATLAB编码器)。
使用coder.cstructname在结构数组上设置基本元素的结构类型的名称，而不是数组的名称。因此，你不能申请coder.cstructname到结构数组元素，然后将其应用到具有不同C结构类型名称的数组。例如，以下代码是不允许的。第二个coder.cstructname试图将基类型的名称设置为myStructArrayName，与前面指定的名称冲突，myStructName．
```
定义带有字段a的标量结构myStruct = struct(“一个”, 0);coder.cstructname (myStruct“myStructName”）;定义带有字段a的结构数组myStructArray = repmat(myStruct,4,6);coder.cstructname (myStructArray“myStructArrayName”）;
```
应用coder.cstructname对结构数组的元素产生与应用相同的结果coder.cstructname到整个结构数组。如果你申请coder.cstructname对于结构数组的元素，必须使用单个下标引用该元素。例如，你可以用var (1)，但不是var (1, 1)．应用coder.cstructname来var (:)产生与应用相同的结果coder.cstructname来var或var (n)．
异构单元格数组在生成的代码中表示为结构。以下是使用时的注意事项coder.cstructname使用单元格数组:
- 在生成代码的函数中，使用coder.cstructname使用单元格数组变量将使单元格数组异构。因此，如果单元格数组是入口点函数输入，并且它的类型是永久同构的，则不能使用coder.cstructname用单元格数组。
- 使用coder.cstructname齐次的编码器。CellType对象intype使返回的对象异构。因此，您不能使用coder.cstructname永久齐次的编码器。CellType对象。有关单元格数组何时永久同构的信息，请参见在命令行指定单元格数组输入(MATLAB编码器)。
- 与a连用时编码器。CellType对象,coder.cstructname创建一个编码器。CellType永久异构的。
当使用命名为的结构时coder.cstructname在具有行为主和列为主数组布局的项目中，代码生成器在某些情况下重命名结构，附加row_或col_到结构名称的开头。这种重命名为两个数组布局中使用的类型提供了惟一的类型定义。
这些建议只适用于MATLAB函数块:
- MATLAB函数块输入输出结构与总线信号相关联。为结构类型生成的名称来自总线信号名称。不要使用coder.cstructname为输入或输出信号命名结构类型。看到在MATLAB函数块中创建结构．
- 代码生成器根据标识符命名规则生成结构类型名称，即使您用coder.cstructname．如果您有嵌入式Coder，您可以自定义命名规则。看到生成标识符的构造(嵌入式编码)。