coder.unroll

在一个文件中，编写入口函数 call_getrand 和一个局部函数 getrand。getrand 展开一个向 n×1 数组分配随机数的 for 循环。call_getrand 使用值 3 调用 getrand。

function z = call_getrand 
%#codegen
z = getrand(3);
end

function y = getrand(n)
coder.inline('never');
y = zeros(n, 1);
coder.unroll();
for i = 1:n
    y(i) = rand();
end
end

生成一个静态库。

codegen -config:lib call_getrand -report

在生成的代码中，代码生成器为三个循环迭代中的每个循环迭代生成 for 循环体的一个副本。

static void getrand(double y[3])
{
  y[0] = b_rand();
  y[1] = b_rand();
  y[2] = b_rand();
}

在一个文件中，编写入口函数 call_getrand_unrollflag 和一个局部函数 getrand_unrollflag。当循环迭代次数小于 10 时，getrand_unrollflag 展开 for 循环。call_getrand 使用值 50 调用 getrand。

function z = call_getrand_unrollflag
%#codegen
z = getrand_unrollflag(50);
end

function y = getrand_unrollflag(n)
coder.inline('never');
unrollflag = n < 10;
y = zeros(n, 1);
coder.unroll(unrollflag)
for i = 1:n
    y(i) = rand();
end
end

生成一个静态库。

codegen -config:lib call_getrand_unrollflag -report

static void getrand_unrollflag(double y[50])
{
  int i;
  for (i = 0; i < 50; i++) {
    y[i] = b_rand();
  }
}

迭代次数不小于 10。因此，代码生成器不会展开 for 循环。它在生成的代码中产生一个 for 循环。

• function z = call_getrand 
  %#codegen
  z = getrand(3);
  end
  
  function y = getrand(n)
  coder.inline('never');
  y = zeros(n, 1);
  for i = coder.unroll(1:n)
      y(i) = rand();
  end
  end

• function z = call_getrand_unrollflag
  %#codegen
  z = getrand_unrollflag(50);
  end
  
  function y = getrand_unrollflag(n)
  coder.inline('never');
  unrollflag = n < 10;
  y = zeros(n, 1);
  for i = coder.unroll(1:n, unrollflag)
      y(i) = rand();
  end
  end