Defined in rt_misc.h, this function raises
a signal to indicate a runtime anomaly. It is not part of the C
library standard, but is supported by the ARM C library as an extension.
Syntaxint __raise(intsignal, inttype);
where:
signalis an integer that holds the signal number.
typeis an integer, string constant or variable that provides additional information about the circumstances that the signal was raised in, for some kinds of signal.
This function calls the normal C signal mechanism or the default signal handler.
You can replace the __raise() function
by defining:
int __raise(intsignal, inttype);
This enables you to bypass the C signal mechanism and its data-consuming signal handler vector, but otherwise gives essentially the same interface as:
void __default_signal_handler(intsignal, inttype);
The default signal handler of the library uses the type __raise() to vary the messages it outputs.
There are three possibilities for a __raise() return
condition:
- no return
The handler performs a long jump or restart.
- 0
The signal was handled.
- nonzero
The calling code must pass that return value to the exit code. The default library implementation calls
_sys_exit(rc)if__raise()returns a nonzero return coderc.
- Concepts
Using the ARM C and C++ Libraries and Floating-Point Support:
- Reference
Using ARM® C and C++ Libraries and Floating-Point Support:
PDF version