t_strerror()

NAME

t_strerror - produce an error message string

SYNOPSIS

#include <xti.h>

const char *t_strerror(
	int errnum)

DESCRIPTION

The t_strerror(3) function has only one parameter.

Parameters Before call After call
errnum x /

The t_strerror(3) 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(3) function. The string is not terminated by a newline character. The language for error message strings written by t_strerror(3) 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(3) 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(3) returns a pointer to the generated message string.

SEE ALSO

t_error(3)