Tcl 8.7/Tk8.7a5 Documentation > Tcl C API > Panic

Tcl/Tk Applications | Tcl Commands | Tk Commands | Tcl C API | Tk C API

NAME

Tcl_Panic, Tcl_PanicVA, Tcl_SetPanicProc, Tcl_ConsolePanic — report fatal error and abort

SYNOPSIS

#include <tcl.h>

void

Tcl_Panic(format, arg, arg, ...)

void

Tcl_PanicVA(format, argList)

void

Tcl_SetPanicProc(panicProc)

void

Tcl_ConsolePanic(format, arg, arg, ...)

ARGUMENTS

DESCRIPTION

SEE ALSO

KEYWORDS

NAME

SYNOPSIS

ARGUMENTS

const char* format (in)

A printf-style format string.

arg (in)

Arguments matching the format string.

va_list argList (in)

An argument list of arguments matching the format string. Must have been initialized using va_start, and cleared using va_end.

Tcl_PanicProc *panicProc (in)

Procedure to report fatal error message and abort.

DESCRIPTION

In a freshly loaded Tcl library, Tcl_Panic prints the formatted error message to the standard error file of the process, and then calls abort to terminate the process. Tcl_Panic does not return. On Windows, when a debugger is running, the formatted error message is sent to the debugger instead. If the windows executable does not have a stderr channel (e.g. wish.exe), then a system dialog box is used to display the panic message.

If your application doesn't use Tcl_Main or Tk_Main and you want to implicitly use the stderr channel of your application's C runtime (instead of the stderr channel of the C runtime used by Tcl), you can call Tcl_SetPanicProc with Tcl_ConsolePanic as its argument. On platforms which only have one C runtime (almost all platforms except Windows) Tcl_ConsolePanic is equivalent to NULL.

Tcl_SetPanicProc may be used to modify the behavior of Tcl_Panic. The panicProc argument should match the type Tcl_PanicProc:

typedef void Tcl_PanicProc(
        const char *format,
        arg, arg,...);

After Tcl_SetPanicProc returns, any future calls to Tcl_Panic will call panicProc, passing along the format and arg arguments. panicProc should avoid making calls into the Tcl library, or into other libraries that may call the Tcl library, since the original call to Tcl_Panic indicates the Tcl library is not in a state of reliable operation.

The typical use of Tcl_SetPanicProc arranges for the error message to be displayed or reported in a manner more suitable for the application or the platform.

Tcl_SetPanicProc can not be used in stub-enabled extensions. Its symbol entry in the stub table is deprecated and it will be removed in Tcl 9.0.

Although the primary callers of Tcl_Panic are the procedures of the Tcl library, Tcl_Panic is a public function and may be called by any extension or application that wishes to abort the process and have a panic message displayed the same way that panic messages from Tcl will be displayed.

Tcl_PanicVA is the same as Tcl_Panic except that instead of taking a variable number of arguments it takes an argument list. Interfaces using argument lists have been found to be nonportable in practice. This function is deprecated and will be removed in Tcl 9.0.

SEE ALSO

KEYWORDS