文档

coder.cstructname

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

折叠所有页面

coder.cstructname为MATLAB使用的生成或外部定义的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(inptype,structName，'extern'，'HeaderFile'， HeaderFile，' align '，align)

描述

例子

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

例子

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

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

coder.cstructname (var，structName“外来的”,“HeaderFile”,headerfile“对齐”,对齐）还指定外部定义的结构类型的运行时内存对齐方式structName．如果你有嵌入式编码器®并使用自定义代码替换库(CRL)，指定对齐方式，以便代码生成器能够匹配需要对结构进行对齐的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结构类型的名称和位置。代码生成器对具有type的变量使用外部定义的结构类型outtype．

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

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

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

例子

全部折叠

在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结构类型为:

类型定义struct {double a;双b;} myStruct;

在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是:

类型定义结构{双f;} mysubStruct;

生成的C结构类型myStruct是:

类型定义struct {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 struct {double f1;双f2;双f3;} myStruct;

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

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

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

写C函数mycadd.c．

#include  #include  #include "mycadd.h" double mycadd(mycstruct *s){返回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外部类型。

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

  1. 定义一个示例结构年代．

  2. 创建类型T从年代通过使用coder.typeof．

  3. 使用coder.cstructname要创建一个类型T1:

    • 具有T．

    • 命名生成的C结构类型myStruct．

  4. 将类型传递给codegen通过使用arg游戏选择。

例如:

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

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

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

输入参数

全部折叠

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

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

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

指定文件的路径:

  • 使用codegen-我选项或其他包含目录参数。MATLAB编码器™应用程序设置自定义代码选项卡。

  • 对于一个MATLAB函数Block，在模拟目标和代码生成>自定义代码窗格,在其他构建信息，设置包括目录参数。

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

例子:“mystruct.h”

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

结构类型对象、单元格数组类型对象、结构变量或用于创建类型对象的单元格数组变量。

限制

  • 你不能申请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,k,n);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编码器)。

    • 当与编码器。CellType对象,coder.cstructname创建一个编码器。CellType永久异构的对象。

  • 这些建议只适用于MATLAB函数块:

    • MATLAB函数块输入和输出结构与总线信号相关联。为结构类型生成的名称来自总线信号名称。不要使用coder.cstructname为输入或输出信号命名结构类型。看到在MATLAB函数块中创建结构．

    • 代码生成器根据标识符命名规则生成结构类型名称，即使将结构类型命名为coder.cstructname．如果您有Embedded Coder，您可以自定义命名规则。看到生成标识符的构造(嵌入式编码)。

另请参阅

主题

在R2011a中引入

这个话题有用吗?
万博1manbetx仿真软件文档
万博1manbetx

试试MATLAB、Sim万博1manbetxulink和其他产品s manbetx 845

现在就去审判吧