Library Development

Develop code replacement library

To get started, see Identify Code Replacement Library Requirements. Get familiar with the process for developing code replacement libraries. Develop libraries interactively with the Code Replacement Tool or programmatically. Experiment with the process and tools by using Quick Start Code Replacement Library Development - Simulink.

Tools

Code Replacement Tool	Create, modify, and validate content of code replacement libraries
Code Replacement Viewer	Explore content of code replacement libraries

Functions

expand all

Tables and Table Entries

`addEntry`	Add table entry to collection of table entries registered in code replacement table
`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`	Create code replacement table entry for a BLAS operation
`RTW.TflCBlasEntryGenerator`	Create code replacement table entry for a CBLAS operation
`RTW.TflCFunctionEntry`	Create code replacement table entry for a function
`RTW.TflCFunctionEntryML`	Custom code replacement table function entry
`RTW.TflCOperationEntry`	Create code replacement table entry for an operator
`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.TflCOperationEntryML`	Custom code replacement table operation entry
`RTW.TflCSemaphoreEntry`	Create code replacement table entry for a semaphore or mutex
`RTW.TflTable`	Create code replacement table
`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

Conceptual and Implementation Arguments

`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

Build Information

`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`	Enable C++ support for function entry in code replacement table
`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

Lookup Tables

`addAlgorithmProperty`	Add algorithm properties for code replacement table entry
`getAlgorithmParameters`	Examine algorithm parameter settings for lookup table function code replacement table entry
`setAlgorithmParameters`	Set algorithm parameters for lookup table function code replacement table entry

Data Alignment and Reserved Identifier Registration

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

Replacement of Code Generated from MATLAB Code

`coder.ceval`	Call C/C++ function from generated code
`coder.dataAlignment`	Specify data alignment for global or entry-point/exported function input and output arguments
`coder.replace`	Replace current MATLAB function implementation with code replacement library function in generated code

Classes

expand all

Conceptual and Implementation Arguments

`RTW.TflArgNumeric`	Numeric argument for code replacement entry
`RTW.TflArgMatrix`	Matrix argument for code replacement entry

Topics

Getting Started

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 Simulink Models
Review lists of functions and operators that the code generator can replace depending on the code replacement library.
Quick Start Code Replacement Library Development - Simulink
Develop a code replacement library that includes an entry for generating replacement code for a math function.

Workflow to Develop a Code Replacement Library

Develop a Code Replacement Library

Workflow for developing a code replacement library.
- STEP 1: Identify Code Replacement Library Requirements
- STEP 2: Define Code Replacement Library Optimizations
- STEP 3: Register Code Replacement Library
- STEP 4: Verify Code Replacement Library
- STEP 5: Deploy Code Replacement Library

Options for More Control

Data Alignment for Code Replacement
Define code replacement mappings that align data for a replacement function to a specified boundary.
Reserved Identifiers and Code Replacement
C/C++ programming language reserved keywords as identifiers and function names in code replacement entries.
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.
Optimize Generated Code by Using Multiple Code Replacement Libraries
Choose multiple code replacement libraries to generate code.

Troubleshooting

Troubleshoot Code Replacement Library Registration

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

Troubleshoot Code Replacement Misses

Analyze and correct code replacement misses with miss reason messages that appear in the Code Replacement Viewer.

Related Information

Code Replacement