主要内容

coder.varsize

声明适应数据

在页面中全部折叠

语法

coder.varsize (varNameN varName1…)
coder.varsize (varName1…,varNameN ubounds)
coder.varsize (varName1…,varNameN ubounds,;

描述

例子

coder.varsize (varName1,…,varNameN)声明命名的变量varName1,…,varNameN拥有可变的大小。声明指示代码生成器允许变量在执行生成的代码期间更改大小。使用这种语法，您不需要指定变量维度的上界，也不需要指定哪些维度可以更改大小。代码生成器计算上界。所有维度,除了单维度，允许改变大小。

使用coder.varsize根据这些限制和指导方针:

  • 使用coder.varsize在MATLAB®用于代码生成的函数。

  • 的coder.varsize声明必须在第一次使用变量之前进行。例如:

    ．.．x = 1;coder.varsize(“x”);disp(大小(x));.．.

  • 使用coder.varsize声明输出参数具有可变大小或处理大小不匹配错误。否则，要定义可变大小的数据，请使用中描述的方法为代码生成定义可变大小的数据．

请注意

为MATLAB函数方法来声明可变大小的输出变量符号窗格和属性检查器。看到声明可变大小的MATLAB函数块变量(模型)．的上界coder.varsize声明时，上界必须与属性检查器中的上界匹配。

有关更多限制和指导原则，请参见限制而且提示．

例子

coder.varsize (varName1,…,varNameN，ubounds)还指定变量的每个维度的上限。所有变量的维数必须相同。所有维度,除了单维度，允许改变大小。

例子

coder.varsize (varName1,…,varNameN，ubounds，会变暗)还指定变量的每个维度的上限，以及每个维度的大小是固定的还是可变的。如果一个维度具有固定的大小，则对应的ubound元素指定维度的固定大小。所有变量都具有相同的固定尺寸尺寸和相同的可变尺寸尺寸。

例子

全部折叠

在使用变量(读)后，更改变量的大小可能会导致大小不匹配错误。使用coder.varsize指定变量的大小可以更改。

以下函数的代码生成会产生大小不匹配错误，原因是x = 1:10的第二个维度的大小x线后y =大小(x)使用x．

函数(x, y) = usevarsize (n)% # codegenx = 1;y =大小(x);如果N > 10 x = 1:10;结束

宣布x可以改变大小，用吗coder.varsize．

函数(x, y) = usevarsize (n)% # codegenx = 1;coder.varsize (“x”）;y =大小(x);如果N > 10 x = 1:10;结束

如果你去掉这条线y =大小(x)，您就不再需要coder.varsize声明,因为x在其大小改变之前不使用。

指定一个是一个行向量，其第二个维度的大小是可变的，上限为20。

函数fcn ()．.．coder.varsize (“一个”20 [1]);．.．结束

当你不提供时会变暗，除了单例维度外，所有维度的大小都是可变的。

指定一个是一个数组，其第一个维度的固定大小为3，第二个维度的可变大小上限为20。

函数fcn ()．.．coder.varsize (“一个”，[3 20]， [0 1]);．.．结束

在这个函数中，语句coder.varsize(“data.values”)声明字段值的每个元素数据具有可变的大小。

函数y = varsize_field ()% # codegend =结构(“值”0 (1,0),“颜色”, 0);Data = repmat(d， [3 3]);coder.varsize (“data.values”）;为I = 1:数值(数据)数据(I)。颜色=兰德- 0.5;数据(我)。值= 1:i;结束y = 0;为i = 1:元素个数(数据)如果数据(我)。Color > 0 y = y + sum(data(i).values);结束结束

指定单元格数组C具有固定大小的第一个维度和可变大小的第二个维度，其上限为3。的coder.varsize的首次使用前必须先声明C．

．.．C = {1 [1 2]};coder.varsize (“C”， [1 3]， [0 1]);y = C {1};．.．结束

没有coder.varsize声明,C是一个异构单元格数组，其元素具有相同的类和不同的大小。与coder.varsize声明,C是一个齐次单元格数组，其元素具有相同的类和最大大小。每个元素的第一个维度固定为1。每个元素的第二个维度的大小都是可变的，上限为3。

指定单元格数组的元素C是具有固定大小的第一个维度和具有上限为5的可变大小的第二个维度的向量。

．.．C = {1 2 3};coder.varsize (“C{:}”， [1 5]， [0 1]);C = {1,1:5, 2:3};．.．

输入参数

全部折叠

要声明为具有可变大小的变量的名称，指定为一个或多个字符向量或字符串标量。

例子:coder.varsize (x, y)

数组尺寸的上界，指定为整数常量的向量。

当您不指定时ubounds，代码生成器计算每个变量的上界。如果ubounds元素对应一个固定大小的维度，其值为该维度的固定大小。

例子:coder.varsize (“x”，'y',[1 2])

指示每个维度的大小是固定的还是可变的，指定为逻辑向量。对应于0或假在会变暗有固定的尺寸。对应于1或真正的拥有可变的大小。

当您不指定时会变暗，维度的大小是可变的，单例维度除外。

例子:coder.varsize (“x”，'y',[1 2], [0 1])

限制

  • 的coder.varsize声明指示代码生成器允许更改变量的大小。它不改变变量的大小。考虑这段代码:

    ．.．x = 7;coder.varsize (“x”(1、5));disp(大小(x));．.．

    后coder.varsize声明,x仍然是1 × 1数组。的当前大小以外的元素不能赋值x．例如，这段代码会产生一个运行时错误，因为索引3超过的维度x．

    ．.．x = 7;coder.varsize (“x”(1、5));x (3) = 1;．.．

  • coder.varsize对于函数输入参数不支持。而不是:

    • 如果函数是一个入口点函数，则使用coder.typeof在命令行。方法指定入口点函数输入参数具有可变大小定义输入类型应用程序的步骤。

    • 如果函数不是入口点函数，则使用coder.varsize在调用函数中，变量是被调用函数的输入。

  • 为稀疏矩阵,coder.varsize删除可变尺寸尺寸的上界。

  • 限制使用coder.varsize细胞数组:

    • 只有在单元格数组是均匀的情况下，它才能具有可变的大小。当你使用coder.varsize对于异构单元格数组，代码生成器试图使单元格数组同构。代码生成器试图找到适用于单元格数组的所有元素的类和最大大小。例如，考虑单元格数组C = {1， [2 3]}．这两个元素都可以用双重类型表示，其第一个维度的大小固定为1，第二个维度的大小可变，上限为2。如果代码生成器找不到公共类和最大大小，则代码生成失败。例如，考虑单元格数组C = {'a'，[2 3]}．代码生成器找不到可以表示这两个元素的类，因为第一个元素是字符第二个元素是双．

    • 如果您使用细胞函数定义固定大小的单元格数组时，不能使用coder.varsize指定单元格数组具有可变大小。例如，此代码会导致代码生成错误，因为x =细胞(1、3)使x固定大小的1 × 3单元阵列。

      ．.．x =细胞(1、3);coder.varsize (“x”[1 5])．.．

      您可以使用coder.varsize使用使用花括号定义的单元格数组。例如:

      ．.．X = {1 2 3};coder.varsize (“x”[1 5])．.．

    • 方法来创建可变大小的单元格数组细胞函数，使用以下代码模式:

      函数mycell (n)% # codegenx =细胞(1,n);为I = 1:n x{I} = I;结束结束

      看到用Cell定义可变大小的Cell阵列．

      要指定单元格数组的上界，请使用coder.varsize．

      函数mycell (n)% # codegenx =细胞(1,n);为I = 1:n x{I} = I;coder.varsize (“x”, 1, 20);结束结束

  • coder.varsize不支持:

    • 全局变量

    • MATLAB类或类属性

    • 字符串标量

更多关于

全部折叠

单维度

维度的大小(dim) = 1．

提示

  • 在代码生成报告或MATLAB函数报告中，冒号(:)表示维度的大小是可变的。例如，大小为1 x: 2指示第一个维度的固定大小为1，第二个维度的可变大小为2。

  • 如果你使用coder.varsize如果要指定维度的上限为1，默认情况下，维度的固定大小为1。类的对应元素可以指定维度为0(空数组)或1会变暗参数真正的．例如，此代码指定的第一个维度x固定大小为1，其他尺寸为可变大小5。

    coder.varsize (“x”(1、5、5))

    的第一个维度x上限为1，大小可变(可以是0或1)。

    coder.varsize (“x”(1、5、5),(1,1,1))

    请注意

    对于一个MATLAB函数块，则不能指定大小为1的输出信号具有可变大小。

  • 如果使用输入变量或使用输入变量的计算结果来指定数组的大小，则在生成的代码中将其声明为variable-size。不重用coder.varsize除非您还想指定其大小的上限。

  • 如果不指定上界coder.varsize声明和代码生成器无法确定上界时，生成的代码使用动态内存分配。动态内存分配可以降低生成代码的速度。为避免动态内存分配，请通过提供ubounds论点。

版本历史

介绍了R2011a

另请参阅

主题

Baidu
map