Funktionsdefinition
R2026bBei der Erstellung von MATLAB®-Funktionen zur Verwendung für die Codegenerierung sind bestimmte Erwägungen erforderlich. Hierzu gehören bestimmte Einschränkungen bei der Verwendung von varargin und varargout, rekursiver Funktionen, anonymer Funktionen und verschachtelter Funktionen. Um Code für rekursive MATLAB Funktionen zu generieren, verwendet der Code-Generator entweder Kompilierzeit- oder Laufzeit-Rekursion. Um effizienten C/C++ Code zu erzeugen, erstellt der Code-Generator manchmal mehrere Versionen einer Funktion, die als Funktionsspezialisierungen bezeichnet werden. In bestimmten Fällen können Sie den Code-Generator mithilfe von coder.ignoreSize und coder.ignoreConst daran hindern, Funktionsspezialisierungen zu erstellen. Beim Erstellen einer MEX-Funktion können Sie die Codegenerierung für eine bestimmte Funktion in Ihrem MATLAB Programmcode umgehen und stattdessen die MATLAB-Engine zur Ausführung des Funktionsaufrufs verwenden. Verwenden Sie hierfür das Konstrukt coder.extrinsic.
Funktionen
%#codegen | Pragma that Indicates a MATLAB function is intended for code generation |
coder.extrinsic | Declare extrinsic function |
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 (Seit R2023b) |
coder.mustBeConst | Validate that value is a compile-time constant (Seit R2023b) |
coder.noImplicitExpansionInFunction | Disable implicit expansion within the specified function in the generated code |
coder.sameSizeBinaryOp | Apply element-wise binary operations without implicit expansion |
coder.specifyAsGPU | Specify that value is a GPU input to an entry-point function for GPU code generation (Seit R2023b) |
Themen
Implizite Erweiterung
- Effects of Implicit Expansion on Generated Code
Implicit expansion in the generated code can affect output sizes, code size, and performance. - Control Implicit Expansion in Generated Code
Disable implicit expansion globally, for specific functions, or for specific operations.
Extrinsische Funktionen
- Using Extrinsic Functions
Use MATLAB to execute a function call in the generated code. - Working With mxArray Outputs in Generated Code
Handle themxArrayobjects returned by extrinsic functions. - Use Extrinsic Functions to Calibrate Data for Standalone Code Generation
Use MATLAB to execute function calls in the generated code.
Validierung von Funktionsargumenten
- 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.
Rekursive, anonyme und verschachtelte Funktionen
- Code Generation for Recursive Functions
Use recursive functions in MATLAB code that is intended for code generation. - Code Generation for Nested and Anonymous MATLAB Functions
Restrictions apply when you use nested or anonymous functions in MATLAB code intended for code generation.
Fehlersuche
Resolve Error: Nonconstant Index into varargin or varargout
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
Troubleshoot duplicate functions in the generated code.
Resolve Error: Output Variable Must Be Assigned Before Run-Time Recursive Call
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
Troubleshoot error when recursion during code generation exceeds the limit.
Fehler beheben: Die Arrays weisen inkompatible Größen auf
Beheben von Fehlern aufgrund von Größeninkompatibilitäten, die bei der Codegenerierung auftreten
Resolve Issue: coder.inline("never") and coder.nonInlineCall Do Not Prevent Function Inlining
Troubleshoot instances of coder.inline('never') not
preventing inlining.
Fehler beheben: Variablen müssen vor ihrer Verwendung vollständig definiert sein
Beheben eines Fehlers bei der Codegenerierung, wenn Variablen vor ihrer Verwendung nicht definiert wurden
Resolve Error: Cannot Determine the Exact Number of Iterations for a Loop
Troubleshoot error when code generator is unable to determine the number of iterations in a loop.
