coder.ignoreSize

Prevent code generator from creating function specializations for constant-size expressions

Syntax

coder.ignoreSize(expression)

Description

coder.ignoreSize(expression) declares that the code generator must not use the constant size of an expression to create function specializations.

Examples

Duplicate Functions Generated for Multiple Input Sizes

If your MATLAB^® code calls a function multiple times and passes inputs of different sizes, the code generator can create function specializations for each size. To avoid this issue, use coder.ignoreSize on the function input. For example, this code uses coder.ignoreSize to avoid creating multiple copies of the function indexOf:

function [out1, out2] = test1(in)
  a = 1:10;
  b = 2:40;
  % Without coder.ignoreSize duplicate functions are generated
  out1 = indexOf(coder.ignoreSize(a), in);
  out2 = indexOf(coder.ignoreSize(b), in);
end

function index = indexOf(array, value)
  coder.inline('never');
  for i = 1:numel(array)
      if array(i) == value
          index = i;
          return
      end
  end
  index = -1;
  return
end

To generate code, enter:

codegen test1 -config:lib -report -args {1}

Input Arguments

expression — Expression whose size is to be treated as nonconstant

MATLAB expression

Example: foo(coder.ignoreSize(1:10))

More About

Function Specialization

Version of a function in which an input type, size, complexity, or value is customized for a particular invocation of the function.

Function specialization produces efficient C code at the expense of code duplication. The code generation report shows all MATLAB function specializations that the code generator creates. However, the specializations might not appear in the generated C/C++ code due to later transformations or optimizations.

Tips

• If you assign an expression to a variable and declare the variable as variable-size by using coder.varsize, this declaration has the same effect as using coder.ignoreSize on the expression.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Version History

Introduced in R2019b