asperror(3x)

NAME
     asperror - print array services error message

SYNOPSIS
     #include <arraysvcs.h>

     void asperror(const char *format, .../* args */);

DESCRIPTION
     asperror produces a message on the standard error output (file descriptor
     2), describing the last error encountered during a call to certain array
     services functions.  The argument string format is treated as a printf-
     style format string and is printed first, followed by a colon and a
     blank, then the message and a newline.  (However, if format is a null
     pointer or points to a null string, the colon is not printed.)  Arguments
     needed to satisfy any conversion specifications in format should follow
     format in the function invocation.

     The error is determined from the external variable aserrorcode, which is
     set by many array services functions when errors occur but not cleared
     when non-erroneous calls are made.

NOTES
     asperror is found in the library "libarray.so", and will be loaded if the
     option "-larray" is used with cc(1) or ld(1).

SEE ALSO
     aserrorcode(3X), asstrerror(3X), printf(3S), array_services(5).