# OS_TPanic

## C Specification

      #include <nitro/os.h>

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

## Description

This function outputs a character string and stops the program.

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

A variable number of arguments can be given using the format character string `fmt`.

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

## Arguments

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

## Return Values

None

## 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