Main Content

ssSetInputPortOptimOpts

Specify reusability of the memory allocated to the input port of an S-function

Syntax

void ssSetInputPortOptimOpts(SimStruct *S, int_T port, uint_T val)

Arguments

S

SimStruct that represents an S-Function block.

port

Index of an input port of S.

val

Reusability of port. Permissible values are

  • SS_NOT_REUSABLE_AND_GLOBAL

  • SS_REUSABLE_AND_LOCAL

  • SS_REUSABLE_AND_GLOBAL

  • SS_NOT_REUSABLE_AND_LOCAL

Description

Use this macro to specify the reusability and scope of the memory allocated to an S-function input port. The reusability indicates if the memory associated with the input port can be overwritten, or not. You must indicate an input port is reusable if you use the ssSetInputPortOverWritable macro to specify the input port's memory can be overwritten by one of the output ports.

The Simulink® engine disregards the memory scope setting, instead treating all S-function ports as global during simulation.

Note

The Simulink Coder™ product uses the memory scope setting you specified when generating code from a model. The Simulink Coder product attempts to declare local variables for any inputs with a local scope. If your S-function uses the inputs in a way that precludes using a local scope, the generated code uses global variables for the inputs. See S-Functions for Multirate Multitasking Environments (Simulink Coder) and S-Functions That Specify Port Scope and Reusability (Simulink Coder) for more information.

Languages

C, C++

Examples

See the S-function sfun_multirate.c used in sfcndemo_sfun_multirate and the S-function sdotproduct.c used in sfcndemo_sdotproduct.

Version History

Introduced before R2006a