ssSetErrorStatus
Report an error
Syntax
void ssSetErrorStatus(SimStruct *S, const char_T *msg)
Arguments
-
S
-
SimStruct representing an S-Function block or a Simulink®model.
-
msg
-
Error message.
Description
Use this function to report errors that occur in your S-function in a single-threaded application. For example:
ssSetErrorStatus(S, "error message"); return;
Note
The error message character vector must be in persistent memory; it cannot be a local variable. If you usesprintf
to format the error message, you must allocate memory for the message. For example:
static char msg[35]; sprintf(msg,"Expected number of parameters: %d",ssGetNumSFcnParams(S)); ssSetErrorStatus(S,msg);
This function causes the Simulink engine to stop and display the specified error message, therefore it is followed by areturn
statement. The function does not generate an exception. Thus you can use it in your S-function to avoid creating exceptions when reporting errors.
Use this function to report errors in single-threaded applications or applications that must run on releases before R2019a. For multi-threaded applications, usessSetLocalErrorStatus
instead.
语言
C, C++
Example
See the S-functionstvctf.c
used insfcndemo_stvctf
.