Man Linux: Main Page and Category List

NAME

       im_error_buffer, im_verror, im_error, im_error_clear, im_warn, im_diag,
       error_exit - handle error messages from VIPS

SYNOPSIS

       #include <vips/vips.h>

       const char *im_error_buffer( void )

       void im_verror( const char *domain, const char *fmt, va_list ap )

       void im_error( const char *domain, const char *fmt, ... )

       void im_error_system( int errno, const char *domain, const  char  *fmt,
       ... )

       void im_error_clear()

       void im_warn( const char *domain, const char *fmt, ... )

       void im_diag( const char *domain, const char *fmt, ... )

       void error_exit( const char *fmt, ... )

DESCRIPTION

       im_error(3)  formats  its  arguments  as printf and appends the string,
       with a newline, to the error buffer. The domain argument indicates  the
       error source and should not be marked for translation.

       For example, the call:

         im_error( "mystuff", _( "bad argument %d" ), a );

       might appear in the error buffer as:

         mystuff: bad argument 12

       im_verror(3) works exactly as im_error(3) but takes stdarg arguments.

       im_error_system(3)  works  exactly as im_error(3) but additionally will
       translate and append a system error code.

       im_error_buffer(3) returns a pointer to the start of the error  buffer.

       im_error_clear(3) empties the error buffer.

       error_exit(3)  formats  its arguments as printf and sends the result to
       the error output, together with the contents of the error  log,  before
       terminating with an error status.

       im_warn(3)  works  as  im_error(),  but  output  is sent to the list of
       warnings.

       If an environment variable IM_WARNING exists, messages are  suppressed.
       Warnings  should  be  used  for non-critical recoverable errors such as
       values being clipped.

       im_diag(3) works as im_error(), but output  is  sent  to  the  list  of
       diagnosic errors.

       If   an   environment  variable  IM_DIAGNOSTICS  exists,  messages  are
       suppressed.  Diagnostics should be used to give  extra  feedback  about
       the result of the operation.

SEE ALSO

       error_exit(3), im_intro(3).

COPYRIGHT

       Birkbeck College

AUTHOR

       N. Dessipris - 22/04/1991

                                 22 April 1991                  IM_ERRORMSG(3)