#include <nitro/os.h>
void OS_Panic( const char *fmt, ... );
fmt | Output format string. |
... | Variable number of arguments |
None.
Outputs a string.
A variable number of arguments can be given using the format string fmt
.
The output format is:
<filename>:<linenumber>
Panic: <string>
<filename> <linenumber>
are the file name and line number describing this OS_Halt()
function. <string>
is created from fmt
and the variable number of arguments.
The maximum string length that can be displayed is 255 characters. If a string with 256 or more characters is specified, all characters from the 256th character are ignored.
This function is used for debugging, so the final ROM version (FINALROM
) will only stop the program (just like OS_Terminate()
).
OS_Panic()
is actually a #define
of OSi_Panic()
. OSi_Panic()
is compiled with weak symbols. Therefore you can overwrite them with your own function definitions.
2009/10/02 Explained the maximum displayable string length.
2004/11/25 Added a description of the weak symbol.
2003/12/01 Initial version.
CONFIDENTIAL