Definición de función
Existen consideraciones especiales cuando se crean funciones de MATLAB® destinadas a la aceleración de punto fijo. Estas incluyen determinadas restricciones al utilizar varargin
y varargout
, funciones recursivas, funciones anónimas y funciones anidadas. Para generar código para las funciones recursivas de MATLAB, el generador de código utiliza recursividad en tiempo de compilación o recursividad en tiempo de ejecución. Para producir código C/C++ eficiente, el generador de código puede crear múltiples versiones de una función, denominadas especializaciones de la función. En algunos casos, puede evitar que el generador de código cree especializaciones de función utilizando coder.ignoreConst
(MATLAB Coder). Cuando se genera una función MEX, se puede omitir la generación de código para una función específica del código de MATLAB y utilizar el motor de MATLAB para ejecutar una llamada. Para ello, utilice la construcción coder.extrinsic
.
Funciones
coder.extrinsic | Declare function as extrinsic and execute it in MATLAB |
coder.ignoreConst | Prevent use of constant value of expression for function specializations |
coder.mustBeConst | Validate that value is a compile-time constant (Desde 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 (Desde R2021b) |
coder.noImplicitExpansionInFunction | Disable implicit expansion within the specified function in the generated code (Desde R2021b) |
coder.read | Read data files at run time in generated code (Desde R2023a) |
coder.write | Create data files that the generated code reads at run time (Desde R2023a) |
Temas
- Compilation Directive %#codegen
Indicate that a MATLAB function is intended for code generation.
- Generate Code with Implicit Expansion Enabled
The code generator introduces modifications in the generated code to accomplish implicit expansion.
- Optimize Implicit Expansion in Generated Code
Implicit expansion in the generated code is enabled by default.
- Code Generation for Variable Length Argument Lists
Generate code for
varargin
andvarargout
. - Generate Code for arguments Block That Validates Input and Output Arguments
Generate code for MATLAB code that constrains class, size, and other aspects of function input and output values.
- Code Generation for Recursive Functions
Use recursive functions in MATLAB code that is intended for code generation.
- Force Code Generator to Use Run-Time Recursion
Rewrite your MATLAB code so that the code generator uses run-time recursion instead of compile-time recursion.
- Code Generation for Anonymous Functions
Use anonymous functions in MATLAB code intended for code generation.
- Code Generation for Nested Functions
Use nested functions in MATLAB code intended for code generation.
- Resolution of Function Calls for Code Generation
The code generator uses precedence rules to resolve function calls.
- Resolution of File Types on Code Generation Path
The code generator uses precedence rules to resolve file types.
- Use MATLAB Engine to Execute a Function Call During Fixed-Point Algorithm Acceleration
If a function is not supported for code generation, declare it as extrinsic to execute in MATLAB.
Solución de problemas
Nonconstant Index into varargin or varargout in a for-Loop
Force loop unrolling when the code generator cannot
determine the value of the index into varargin
or varargout
.
Output Variable Must Be Assigned Before Run-Time Recursive Call
Troubleshoot output variable assignment for run-time recursion.
Compile-Time Recursion Limit Reached
Troubleshoot compile-time recursion limit error.