t_strerror() — Produce an error message string

Standards

Standards / Extensions C or C++ Dependencies
XPG4.2 both  

Format

#define _XOPEN_SOURCE_EXTENDED 1
#include <xti.h>

char *t_strerror(int errnum);

General description

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 should 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. If the calling program is operating in any one of the C, POSIX, SAA or S370 locales, then the error message string describing the value in t_errno is identical to the comments following the t_errno codes defined in <xti.h>. Note that no message number is prefixed to the message text in this situation. 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 - except for T_UNINIT

Returned value

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

Related information