ライブラリの開発

コード置換ライブラリの開発

コード置換のカスタマイズの詳細、実行する理由、置換できる内容、制限事項について学習します。コード置換ライブラリを開発するプロセスをよく理解します。ライブラリをコード置換ツールを使用して対話形式で開発するかプログラムで開発します。Quick Start Library Developmentを使用してプロセスとツールについて実験します。

ツール

コード置換ツール	コード置換ライブラリの内容の作成、変更、および検証
コード置換ビューアー	コード置換ライブラリの内容の調査

関数

すべて展開する

テーブルおよびテーブルエントリ

`addEntry`	コード置換テーブルに登録されているテーブルエントリのコレクションにテーブルエントリを追加
`createCRLEntry`	Create code replacement table entry from conceptual and implementation argument string specifications
`registerCFunctionEntry`	Create function entry based on specified parameters and register in code replacement table
`registerCPPFunctionEntry`	Create C++ function entry based on specified parameters and register in code replacement table
`registerCPromotableMacroEntry`	Create promotable code replacement macro entry based on specified parameters and register in code replacement table (for `abs` function replacement only)
`RTW.TflBlasEntryGenerator`	BLAS 演算のコード置換テーブルエントリを作成
`RTW.TflCBlasEntryGenerator`	CBLAS 演算のコード置換テーブルエントリを作成
`RTW.TflCFunctionEntry`	関数のコード置換テーブルエントリを作成
`RTW.TflCFunctionEntryML`	Custom code replacement table function entry
`RTW.TflCOperationEntry`	演算子のコード置換テーブルエントリの作成
`RTW.TflCOperationEntryML`	Custom code replacement table operation entry
`RTW.TflCOperationEntryGenerator`	Create code replacement table entry for a fixed-point addition or subtraction operation
`RTW.TflCOperationEntryGenerator_NetSlope`	Create code replacement table entry for a net slope fixed-point operation
`RTW.TflCSemaphoreEntry`	Create code replacement table entry for a semaphore or mutex
`RTW.TflTable`	コード置換テーブルを作成
`setTflCFunctionEntryParameters`	Set specified parameters for function entry in code replacement table
`setTflCOperationEntryParameters`	Set specified parameters for operator entry in code replacement table
`setTflCSemaphoreEntryParameters`	Set specified parameters for semaphore entry in code replacement table

概念引数と実装引数

`addConceptualArg`	Add conceptual argument to array of conceptual arguments for code replacement table entry
`addDWorkArg`	Add DWork argument for entry in code replacement table
`copyConceptualArgsToImplementation`	Copy conceptual argument specifications to implementation specifications of an entry for code replacement table entry
`createAndAddImplementationArg`	Create implementation argument from specified properties and add to implementation arguments for code replacement table entry
`createAndSetCImplementationReturn`	Create implementation return argument from specified properties and add to implementation for code replacement table entry
`createCRLEntry`	Create code replacement table entry from conceptual and implementation argument string specifications
`createAndAddConceptualArg`	Create conceptual argument from specified properties and add to conceptual arguments for code replacement table entry
`getTflArgFromString`	Create code replacement argument based on specified name and built-in data type
`getTflDWorkFromString`	Create code replacement DWork argument for semaphore entry based on specified name and data type

ビルド情報

`addAdditionalHeaderFile`	Add header file to array of header files for code replacement table entry
`addAdditionalIncludePath`	Add include path to array of include paths for code replacement table entry
`addAdditionalLinkObj`	Add link object to array of link objects for code replacement table entry
`addAdditionalLinkObjPath`	Add link object path to array of link object paths for code replacement table entry
`addAdditionalSourceFile`	Add source file to array of source files for code replacement table entry
`addAdditionalSourcePath`	Add source path to array of source paths for code replacement table entry

C++

`enableCPP`	コード置換テーブルの関数エントリに対する C++ サポートの有効化
`registerCPPFunctionEntry`	Create C++ function entry based on specified parameters and register in code replacement table
`setNameSpace`	Set namespace for C++ function entry in code replacement table

データ配置および予約済み識別子の登録

`addComplexTypeAlignment`	Specify alignment boundary of a complex type
`setReservedIdentifiers`	Register reserved identifiers to associate with code replacement library

MATLAB コードから生成されたコードの置換

`coder.ceval`	外部 C/C++ 関数の呼び出し
`coder.dataAlignment`	Specify data alignment for global or entry-point/exported function input and output arguments
`coder.replace`	生成コード内で現在の MATLAB 関数実装をコード置換ライブラリ関数に置換

トピック

入門

What Is Code Replacement Customization?
Customize how and when the code generator replaces C/C++ code that it generates for functions and operators.
Code You Can Replace from MATLAB Code
Review lists of functions and operators the code generator can replace depending on the code replacement library that you specify.
Quick Start Library Development
Develop a code replacement library that includes an entry for generating replacement code for a math function.

コード置換ライブラリを開発するワークフロー

コード置換ライブラリの開発

コード置換ライブラリの開発ワークフロー。
- ステップ 1: コード置換ライブラリの要件の特定
- ステップ 2: Define Code Replacement Library Optimizations
- ステップ 3: Register Code Replacement Library
- ステップ 4: Verify Code Replacement Library
- ステップ 5: コード置換ライブラリの展開

より詳細な制御のオプション

Data Alignment for Code Replacement
Define code replacement mappings that align data for a replacement function to a specified boundary.
Array Layout and Code Replacement
Define code replacement mappings that specify data layout for storing array elements in memory.
Allow Shape Agnostic Match
Shape-agnostic matrix replacement for Embedded Coder CRL.
予約済み識別子とコード置換
C/C++ プログラミング言語でコード置換エントリの識別子および関数名として予約されているキーワード。
Remap Operator Output to Function Input
Meet specific generated code patterns by remapping operator outputs to input positions in your replacement function argument list.
Customize Match and Replacement Process
Add logic to the code replacement match and replacement process for functions or operators.

トラブルシューティング

Troubleshoot Code Replacement Library Registration

If a code replacement library is not listed as a configuration option or does not appear in the Code Replacement Viewer, troubleshoot the library registration.

Troubleshoot Code Replacement Misses

Use miss reason messages that appear in the Code Replacement Viewer to analyze and correct code replacement misses.