ssttrreerrrroorr() -- String Function (libc)

Translate an error number into a string
#iinncclluuddee <ssttrriinngg.hh>
cchhaarr *ssttrreerrrroorr(_e_r_r_o_r)
iinntt _e_r_r_o_r;

ssttrreerrrroorr()  helps to  generate  an error  message.  It  takes the  argument
_e_r_r_o_r, which presumably is an error code generated by an error condition in
a program, and may return a pointer to the corresponding error message.

The  error numbers  recognized  and the  texts of  the corresponding  error
messages are set by COHERENT.

_S_e_e _A_l_s_o
lliibbcc, ppeerrrroorr(), ssttrriinngg.hh
ANSI Standard, section 7.11.6.2

_N_o_t_e_s
ssttrreerrrroorr() returns a pointer to a static array that may be overwritten by a
subsequent call to ssttrreerrrroorr().

ssttrreerrrroorr()  differs from  the related  function  ppeerrrroorr() in  the following
ways:  ssttrreerrrroorr() receives  the error  number  through its  argument _e_r_r_o_r,
whereas ppeerrrroorr() reads  the global constant eerrrrnnoo. Also, ssttrreerrrroorr() returns
a  pointer  to  the error  message,  whereas  ppeerrrroorr()  writes the  message
directly into the standard error stream.

The error numbers recognized and  the texts of the messages associated with
each error  number are set  by COHERENT.  However,  ssttrreerrrroorr() and ppeerrrroorr()
return the same error message when handed the same error number.
