NAME

t_strerror - produce an error message string

SYNOPSIS

#include <xti.h>

const char *t_strerror(int errnum);

DESCRIPTION

Parameters	Before call	After call
errnum	x	/

The t_strerror() function maps the error number in errnum that corresponds to an XTI error to a language-dependent error message string and returns a pointer to the string. The string pointed to will not be modified by the program, but may be overwritten by a subsequent call to the t_strerror function. The string is not terminated by a newline character. The language for error message strings written by t_strerror() is that of the current locale. If it is English, the error message string describing the value in t_errno may be derived from the comments following the t_errno codes defined in <xti.h>. If an error code is unknown, and the language is English, t_strerror() returns the string:

 

"<error>: error unknown"

where <error> is the error number supplied as input. In other languages, an equivalent text is provided.

VALID STATES

ALL - apart from T_UNINIT

RETURN VALUE

The function t_strerror() returns a pointer to the generated message string.

SEE ALSO

t_error()

CHANGE HISTORY

Issue 4

The SYNOPSIS section is placed in the form of a standard C function prototype.