first previous next last contents


#include <text_output.h>
void verror(int priority, char *name, char *fmt, ...);

This C function displays text in the error output window or prints to stderr when in a non graphical environment. The priority argument may be one of ERR_WARN or ERR_FATAL. The name argument is used as part of the error message, along with the time stamp and the error itself. name should not be any more than 50 characters long, and ideally much shorter. The fmt arguments onwards form the standard printf style arguments of a format specifier and string components.

An error with priority of ERR_WARN will be sent only to the error window. Priority ERR_FATAL will print to stderr as well. ERR_FATAL should be used in conditions where there is a chance that the program may subsequently crash, thus removing the error window from the screen and preventing users from reporting error messages.

vmessage priority text ?...?

This is the Tcl interface to the verror C function. The priority argument should be one of ERR_WARN or ERR_FATAL as described above. The text and subsequent arguments make up the contents of the error message itself with each argument concatenated with a single space between arguments. The Tcl (not C) implementation of verror currently has a limit of 8192 bytes of error message per call.

first previous next last contents
This page is maintained by staden-package. Last generated on 1 March 2001.