During C/C++ code generation, the code generator checks for statements that attempt to access uninitialized memory. If it detects execution paths where a variable is used but is potentially not defined, it generates a compile-time error. To prevent these errors, define variables by assignment before using them in operations or returning them as function outputs.
Note, however, that variable assignments not only copy the properties
of the assigned data to the new variable, but also initialize the
new variable to the assigned value. This forced initialization sometimes
results in redundant copies in C/C++ code. To eliminate redundant
copies, define uninitialized variables by using the coder.nullcopy
function, as described
in How to Eliminate Redundant Copies by Defining Uninitialized Variables.
Define the variable with coder.nullcopy
.
Initialize the variable before reading it.
When the uninitialized variable is an array, you must initialize all of its elements before passing the array as an input to a function or operator — even if the function or operator does not read from the uninitialized portion of the array.
In the following code, the assignment statement X = zeros(1,N)
not only
defines X
to be a 1-by-5 vector of real doubles, but also initializes
each element of X
to zero.
function X = withoutNullcopy %#codegen N = 5; X = zeros(1,N); for i = 1:N if mod(i,2) == 0 X(i) = i; elseif mod(i,2) == 1 X(i) = 0; end end
This forced initialization creates an extra copy in the generated code. To eliminate this
overhead, use coder.nullcopy
in the definition of
X
:
function X = withNullcopy %#codegen N = 5; X = coder.nullcopy(zeros(1,N)); for i = 1:N if mod(i,2) == 0 X(i) = i; else X(i) = 0; end end