代码替换查看器

Explore content of code replacement libraries

expand all in page

Description

The Code Replacement Viewer displays the content of code replacement libraries and tables. You can use this tool to explore and choose a code replacement library or to view a predefined code replacement table. If you develop a custom code replacement library, you can use this viewer to verify table entries for the following properties:

Argument order is correct.
Conceptual argument names match code generator naming conventions.
实现argument names are correct.
Header or source file specification is not missing.
I/O types are correct.
Relative priority of entries is correct (highest priority is 0, and lowest priority is 100).
Saturation or rounding mode specifications are not missing.

If you specify a library name when you open the viewer, the viewer displays the code replacement tables for that library. If you specify a table name when you open the viewer, the viewer displays the function and operator code replacement entries for that table. The viewer can only display code replacement tables that are defined. For more information on creating code replacement tables, seeDefine Code Replacement Library Optimizations(Embedded Coder).

Abbreviated Entry Information

In the middle pane, the viewer displays entries that are in the selected code replacement table, along with abbreviated information for each entry.

Field	Description
Name	Name or identifier of the function or operator being replaced (for example,`cos`or`RTW_OP_ADD`).
实现	Name of the implementation function, which can match or differ fromName.
NumIn	Number of input arguments.
In1Type	Data type of the first conceptual input argument.
In2Type	Data type of the second conceptual input argument.
OutType	Data type of the conceptual output argument.
Priority	The entry's match priority, relative to other entries of the same name and to the conceptual argument list within the selected code replacement library. The priority can range from 0 to 100, with 0 being the highest priority. The default is 100. If the library provides two implementations for a function or operator, the implementation with the higher priority shadows the one with the lower priority.
UsageCount	Not used.

Detailed Entry Information

In the middle pane, when you select an entry, the viewer displays entry details.

Field Description

Description Text description of the table entry (can be empty).

Key Name or identifier of the function or operator being replaced (for example,cosorRTW_OP_ADD), and the number of conceptual input arguments.

实现 Name of the implementation function, and the number of implementation input arguments.

实现type Type of implementation:FCN_IMPL_FUNCT对函数或FCN_IMPL_MACROfor macro.

Saturation mode

Saturation mode that the implementation function supports. One of:

RTW_SATURATE_ON_OVERFLOW

RTW_WRAP_ON_OVERFLOW

RTW_SATURATE_UNSPECIFIED

Rounding modes

Rounding modes that the implementation function supports. One or more of:

RTW_ROUND_FLOOR

RTW_ROUND_CEILING

RTW_ROUND_ZERO

RTW_ROUND_NEAREST

RTW_ROUND_NEAREST_ML

RTW_ROUND_SIMPLEST

RTW_ROUND_CONV

RTW_ROUND_UNSPECIFIED

GenCallback file Not used.

实现header Name of the header file that declares the implementation function.

实现source Name of the implementation source file.

Priority The entry's match priority, relative to other entries of the same name and to the conceptual argument list within the selected code replacement library. The priority can range from 0 to 100, with 0 being the highest priority. The default is 100. If the library provides two implementations for a function or operator, the implementation with the higher priority shadows the one with the lower priority.

Total Usage Count Not used.

Entry class Class from which the current table entry is instantiated.

Conceptual arguments Name, I/O type (RTW_IO_OUTPUTorRTW_IO_INPUT), and data type for each conceptual argument.

实现 Name, I/O type (RTW_IO_OUTPUTorRTW_IO_INPUT), data type, and alignment requirement for each implementation argument.

Fixed-Point Entry Information

When you select an operator entry that specifies net slope fixed-point parameters, the viewer displays fixed-point information.

Field	Description
Net slope adjustment factor F	Slope adjustment factor (F) part of the net slope factor, F2^E, for net slope table entries. You use this factor with fixed-point multiplication and division replacement to map a range of slope and bias values to a replacement function.
Net fixed exponent E	Fixed exponent (E) part of the net slope factor, F2^E, for net slope table entries. You use this fixed exponent with fixed-point multiplication and division replacement to map a range of slope and bias values to a replacement function.
Slopes must be the same	Indicates whether code replacement request processing must check that the slopes on arguments (input and output) are equal. You use this information with fixed-point addition and subtraction replacement to disregard specific slope and bias values, and map relative slope and bias values to a replacement function.
Must have zero net bias	Indicates whether code replacement request processing must check that the net bias on arguments is zero. You use this information with fixed-point addition and subtraction replacement to disregard specific slope and bias values, and map relative slope and bias values to a replacement function.

Open the Code Replacement Viewer

Open from the MATLAB^®command prompt usingcrviewer.

Examples

expand all

Display Contents of Code Replacement Library

This example opens the registered code replacement libraryGNU C99 extensions.

crviewer('GNU C99 extensions')

Display Contents of Code Replacement Table

This example opens a predefined code replacement tablecrl_table_sinfcn. To learn how to create this example table, seeDefine Code Replacement Library Optimizations(Embedded Coder).

crviewer(crl_table_sinfcn)

Related Examples

Choose a Code Replacement Library

Programmatic Use

expand all

`crviewer('library')`

crviewer('library')opens the Code Replacement Viewer and displays the contents of图书馆, where图书馆is a character vector that names a registered code replacement library.

`crviewer(table)`

crviewer(table)opens the Code Replacement Viewer and displays the contents of a predefinedtable, wheretableis a MATLAB file that defines code replacement tables. The table must be user predefined and the file must be in the current folder or on the MATLAB path.