tt_error(library call) tt_error(library call)
NAMEtt_error — capture ToolTalk function errors
SYNOPSIS
#include <Tt/tt_c.h>
void tt_error(
const char *funcname,
Tt_status status);
DESCRIPTION
The tt_error function is a publicly-known null function. It is called
by the ToolTalk library just before it returns from any ToolTalk API
call that has a status other than TT_OK. The caller passes the name of
the function that is about to return and the function's status code.
You can use this function to set a dbx breakpoint to quickly catch and
trace back any ToolTalk errors. You can also interpose this function,
for example, to log ToolTalk errors to stderr.
ARGUMENTS
funcname Specifies the name of the function.
status Specifies the function's return status value.
RETURN VALUE
None.
APPLICATION USAGE
The following code example shows how an application might interpose
this function to log ToolTalk errors to stderr:
void tt_error(const char *funcname, Tt_status status) {
fprintf(stderr, "ToolTalk function %s returned %s.0,
funcname, tt_status_message(status));
}
SEE ALSO
Tt/tt_c.h - Tttt_c(5)
tt_error(library call)