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.