OS_TPanic

Syntax

#include <nitro/os.h>

void OS_TPanic( const char *fmt, ... );

Arguments

Return Values

None.

Description

Outputs a string.

Internally, this function calls OS_VSNPrintf(). Therefore the useable string format (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

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

CONFIDENTIAL