Keep extrinsic calls

Extrinsic function call support

Description

App Configuration Pane: Speed

Configuration Objects: coder.MexCodeConfig

The Keep extrinsic calls parameter specifies whether the code generator produces a call to MATLAB^® for an extrinsic function. An extrinsic function is a function on the MATLAB path that the code generator dispatches to MATLAB for execution. The code generator does not compile or generate code for extrinsic functions.

Disabling this parameter can result in faster MEX execution. Do not disable this parameter if your MEX function relies on extrinsic calls.

If you disable the Keep extrinsic calls parameter, the generated MEX function cannot display run-time messages from error and assert statements in your MATLAB code. Instead, the MEX function reports that it cannot display the error message. To see the error message, enable the Keep extrinsic calls parameter and generate the MEX function again.

The setting of the Keep extrinsic calls parameter affects how a MEX function generates random numbers for the functions rand, randi, and randn. If you disable the Keep extrinsic calls parameter, the MEX function uses a self-contained random number generator. Otherwise, the MEX function uses the MATLAB global random number stream.

Settings

On

This value is the default value.

For an extrinsic function, the code generator produces a call to a MATLAB function. The code generator does not generate code for the extrinsic function.

Off

The code generator ignores an extrinsic function. It does not generate code for the call to the MATLAB function. If the extrinsic function affects the output of the MATLAB function, the code generator issues a warning.

Programmatic Use

Property: ExtrinsicCalls

Values: true | false

Default: true

Version History

Introduced in R2011a