STPerror(3)

NAME
     STPerror, STErrorString - libstiff execution error handling

SYNOPSIS
     #include <stdio.h>
     #include <stiff.h>

     void STPerror(char *s);

     char* STErrorString(int err);

     extern int STerrno;

DESCRIPTION
     STPerror prints error messages to standard error in a format similar to
     the standard C library function perror(3C). If an error occurs during a
     libstiff function call, the global error variable STerrno will be set
     with an error code.  The symbolic names for these error codes are defined
     in stiff.h.

     The value of STerrno is used by STPerror as an index to a table of error
     messages.  This table is formatted as a list of strings. The error string
     corresponding to a given error code can be obtained using the
     STErrorString function.

     A call to STPerror will print the user-supplied string s followed by a
     colon (:), a space, and the error message corresponding to the current
     value of STerrno. If the string s is the NULL string (""), no colon or
     space will be printed, only the error message.

     To be of most use, a call to STPerror should be made immediately
     following the libstiff function call where an error has been detected.

NOTE
     If an error occurs and STerrno is set to STESYSCALL, then the standard C
     error variable errno can be used along with the standard C function
     perror to obtain additional information about the error.

SEE ALSO
     libstiff(3), perror(3C).