home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / STPerror.z / STPerror
Encoding:
Text File  |  2002-10-03  |  2.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTPPPPeeeerrrrrrrroooorrrr((((3333))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSTTTTPPPPeeeerrrrrrrroooorrrr((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      STPerror, STErrorString - libstiff execution error handling
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttiiiiffffffff....hhhh>>>>
  14.  
  15.      vvvvooooiiiidddd SSSSTTTTPPPPeeeerrrrrrrroooorrrr((((cccchhhhaaaarrrr ****ssss))));;;;
  16.  
  17.      cccchhhhaaaarrrr**** SSSSTTTTEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg((((iiiinnnntttt eeeerrrrrrrr))));;;;
  18.  
  19.      eeeexxxxtttteeeerrrrnnnn iiiinnnntttt SSSSTTTTeeeerrrrrrrrnnnnoooo;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _S_T_P_e_r_r_o_r prints error messages to standard error in a format similar to
  23.      the standard C library function _p_e_r_r_o_r(_3_C). If an error occurs during a
  24.      _l_i_b_s_t_i_f_f function call, the global error variable _S_T_e_r_r_n_o will be set
  25.      with an error code.  The symbolic names for these error codes are defined
  26.      in _s_t_i_f_f._h.
  27.  
  28.      The value of _S_T_e_r_r_n_o is used by _S_T_P_e_r_r_o_r as an index to a table of error
  29.      messages.  This table is formatted as a list of strings. The error string
  30.      corresponding to a given error code can be obtained using the
  31.      _S_T_E_r_r_o_r_S_t_r_i_n_g function.
  32.  
  33.      A call to _S_T_P_e_r_r_o_r will print the user-supplied string _s followed by a
  34.      colon (:), a space, and the error message corresponding to the current
  35.      value of _S_T_e_r_r_n_o. If the string _s is the NULL string (""), no colon or
  36.      space will be printed, only the error message.
  37.  
  38.      To be of most use, a call to _S_T_P_e_r_r_o_r should be made immediately
  39.      following the _l_i_b_s_t_i_f_f function call where an error has been detected.
  40.  
  41. NNNNOOOOTTTTEEEE
  42.      If an error occurs and _S_T_e_r_r_n_o is set to SSSSTTTTEEEESSSSYYYYSSSSCCCCAAAALLLLLLLL, then the standard C
  43.      error variable _e_r_r_n_o can be used along with the standard C function
  44.      _p_e_r_r_o_r to obtain additional information about the error.
  45.  
  46. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  47.      libstiff(3), perror(3C).
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.