OS_Panic

Syntax

#include <nitro/os.h>

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

Arguments

fmt Output format string.
... Variable number of arguments

Return Values

None.

Description

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

Internal Operation

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.

See Also

OS_Warning
OS_Terminate

Revision History

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