Définition de fonction
Vous devez prendre en compte certains éléments lorsque vous créez des fonctions MATLAB® destinées à la génération de code. Parmi ces éléments, citons certaines restrictions lorsque vous utilisez varargin et varargout, des fonctions récursives, des fonctions anonymes et des fonctions imbriquées. Pour générer du code pour des fonctions récursives MATLAB, le générateur de code utilise la récursion au moment de la compilation ou en cours d’exécution. Pour produire du code C/C++ efficace, le générateur de code crée parfois plusieurs versions d’une fonction, appelées spécialisations d’une fonction. Dans certains cas, vous pouvez éviter que le générateur de code ne crée de spécialisations d’une fonction avec coder.ignoreSize et coder.ignoreConst. Lors de la génération d’une fonction MEX, vous pouvez contourner la génération de code d’une fonction spécifique dans votre code MATLAB et utiliser à la place le moteur MATLAB pour exécuter l’appel. Pour ce faire, utilisez la construction coder.extrinsic.
Fonctions
coder.extrinsic | Declare function as extrinsic and execute it in MATLAB |
coder.ignoreConst | Prevent use of constant value of expression for function specializations |
coder.ignoreSize | Prevent code generator from creating function specializations for constant-size expressions |
coder.mustBeComplex | Validate that value lies on the complex plane (depuis R2023b) |
coder.mustBeConst | Validate that value is a compile-time constant (depuis R2023b) |
coder.noImplicitExpansionInFunction | Disable implicit expansion within the specified function in the generated code (depuis R2021b) |
coder.sameSizeBinaryOp | Apply element-wise binary operations without implicit expansion (depuis R2021b) |
coder.specifyAsGPU | Specify that value is a GPU input to an entry-point function for GPU code generation (depuis R2023b) |
Rubriques
- 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
vararginandvarargout. - 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 in Generated Code
If a function is not supported for code generation, declare it as extrinsic to execute in MATLAB.
Résolution des problèmes
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.
Avoid Duplicate Functions in Generated Code
Reduce the occurrence of duplicate functions in the generated code.
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.
Résoudre l’erreur : tableaux de tailles incompatibles
Résoudre les erreurs d’incompatibilité de taille qui se produisent pendant la génération de code.
Resolve Issue: coder.inline("never") and coder.nonInlineCall Do Not Prevent Function Inlining
Troubleshoot instances of coder.inline('never') not
preventing inlining.
Résoudre le problème : les variables doivent être entièrement définies avant utilisation
Résoudre les erreurs de génération de code lorsque les variables, y compris les champs de structure et les propriétés de classe, ne sont pas définies avant utilisation.
Resolve Error: Cannot Determine the Exact Number of Iterations for a Loop
Troubleshoot error when code generator is unable to correctly determine number of loop iterations.
