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  for­
       mat  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  aser­
       rorcode,  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_ser­
       vices(5).


Man(1) output converted with man2html