Library Development

Develop code replacement library

Learn about what code replacement customization is, why do it, what you can replace, and limitations. 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 Library Development.

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.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`	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

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

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 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.

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.
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.
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.

Troubleshooting

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.

Related Information

Code Replacement