OS_TPanic

C Specification

#include <nitro/os.h>

void OS_TPanic( const char *fmt, ...

Arguments

fmt Character string output format (character string format)
... Variable number of arguments

Return Values

None.

Description

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() ).

Internal Operation

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.

See Also

OS_TWarning, OS_Terminate

Revision History

11/25/2004 Added description of weak symbols.
09/10/2004 Initial version