Definizione della funzione
R2026bEsistono delle considerazioni particolari quando si creano funzioni di MATLAB® destinate ad essere utilizzate in un blocco MATLAB Function. Queste considerazioni particolari includono alcune restrizioni nell'utilizzo di varargin e varargout, delle funzioni ricorsive, delle funzioni anonime e delle funzioni annidate. Per generare codice per le funzioni ricorsive di MATLAB, il generatore di codice utilizza la ricorsione a tempo di compilazione o la ricorsione a tempo di esecuzione. Per produrre codice C/C++ efficiente, il generatore di codice crea talvolta più versioni di una funzione, chiamate specializzazioni della funzione. In alcuni casi, è possibile impedire al generatore di codice di creare le specializzazioni della funzione utilizzando coder.ignoreSize e coder.ignoreConst. È possibile escludere la generazione di codice per una funzione specifica nel codice MATLAB e utilizzare invece il motore di MATLAB per eseguire la chiamata. A tal fine, utilizzare il costrutto coder.extrinsic.
Blocchi
| MATLAB Function | Include MATLAB code in Simulink models | |
| MATLAB System | Include System object in model |
Funzioni
coder.extrinsic | Dichiarare la funzione come estrinseca ed eseguirla in MATLAB |
coder.ignoreSize | Prevent code generator from creating function specializations for constant-size expressions |
coder.ignoreConst | Prevent use of constant value of expression for function specializations |
coder.mustBeConst | Validate that value is a compile-time constant (Da R2023b) |
coder.unroll | Unroll for-loop by making a copy of
the loop body for each loop iteration |
coder.sameSizeBinaryOp | Apply element-wise binary operations without implicit expansion |
coder.noImplicitExpansionInFunction | Disable implicit expansion within the specified function in the generated code |
coder.read | Read data files at run time in generated code (Da R2023a) |
coder.write | Create data files that the generated code reads at run time (Da R2023a) |
Argomenti
- Effects of Implicit Expansion on Generated Code (MATLAB Coder)
Implicit expansion in the generated code can affect output sizes, code size, and performance.
- Control Implicit Expansion in Generated Code (MATLAB Coder)
Disable implicit expansion globally, for specific functions, or for specific operations.
- Generate Code for arguments Block That Validates Input and Output Arguments (MATLAB Coder)
Generate code for MATLAB code that constrains class, size, and other aspects of function input and output values.
- Code Generation for Recursive Functions (MATLAB Coder)
Use recursive functions in MATLAB code that is intended for code generation.
- Code Generation for Nested and Anonymous MATLAB Functions (MATLAB Coder)
Restrictions apply when you use nested or anonymous functions in MATLAB code intended for code generation.
- Using Extrinsic Functions (MATLAB Coder)
Use MATLAB to execute a function call in the generated code.
- Working With mxArray Outputs in Generated Code (MATLAB Coder)
Handle the
mxArrayobjects returned by extrinsic functions.
Risoluzione dei problemi
Resolve Error: Nonconstant Index into varargin or varargout (MATLAB Coder)
Troubleshoot error when the code generator cannot determine the value of an index
into varargin or varargout inside a
for-loop.
Troubleshoot Replicated Functions in Generated Code (MATLAB Coder)
Troubleshoot duplicate functions in the generated code.
Resolve Error: Output Variable Must Be Assigned Before Run-Time Recursive Call (MATLAB Coder)
Troubleshoot error when the MATLAB code does not assign a value to an output variable before a recursive call.
Resolve Error: Compile-Time Recursion Limit Reached (MATLAB Coder)
Troubleshoot error when recursion during code generation exceeds the limit.
Resolve Error: Arrays Have Incompatible Sizes (MATLAB Coder)
Troubleshoot size incompatibility errors that occur during code generation.