#include <nitro/os.h>
void OS_TPanic( const char *fmt, ...
| fmt | Character string output format (character string format) |
| ... | Variable number of arguments |
None.
This function outputs a character string.
Internally, this function calls OS_VSNPrintf(). Therefore the useable character string format (character string output format) is more restricted than it would be with OS_Panic(). However, you can save on the code and stack overhead by using this function instead of OS_Panic().
The output format is:
<filename>:<linenumber> Panic: <string>
<filename> <linenumber> are the file name and line number describing this OS_Panic() function. <string> is created from fmt and the variable number of arguments.
This function is used for debugging, so the final ROM version (FINALROM) will only stop the program (just like OS_Terminate() ).
OS_TPanic() is actually a #define of OSi_TPanic(). OSi_TPanic() is compiled with weak symbols. Therefore you can overwrite them with your own function definitions.
11/25/2004 Added description of weak symbols.
09/10/2004 Initial version
CONFIDENTIAL