Eliminate Redundant Copies of Variables in Generated Code - MATLAB & Simulink (original) (raw)
Main Content
When Redundant Copies Occur
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.
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.
What happens if you access uninitialized data?
Uninitialized memory contains arbitrary values. Therefore, accessing uninitialized data may lead to segmentation violations or nondeterministic program behavior (different runs of the same program may yield inconsistent results).
Defining Uninitialized Variables
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 ofX:
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