1IM_ERRORMSG(3)             Library Functions Manual             IM_ERRORMSG(3)
2
3
4

NAME

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

SYNOPSIS

10       #include <vips/vips.h> #include <vips/stdarg.h>
11
12       const char *im_error_buffer( void )
13
14       void im_verror( const char *domain, const char *fmt, va_list ap )
15
16       void im_error( const char *domain, const char *fmt, ... )
17
18       void im_error_system( int errno, const char *domain, const  char  *fmt,
19       ... )
20
21       void im_error_clear()
22
23       void im_warn( const char *domain, const char *fmt, ... )
24
25       void im_diag( const char *domain, const char *fmt, ... )
26
27       void error_exit( const char *fmt, ... )
28
29

DESCRIPTION

31       im_error(3)  formats  its  arguments  as printf and appends the string,
32       with a newline, to the error buffer. The domain argument indicates  the
33       error source and should not be marked for translation.
34
35       For example, the call:
36
37         im_error( "mystuff", _( "bad argument %d" ), a );
38
39       might appear in the error buffer as:
40
41         mystuff: bad argument 12
42
43       im_verror(3) works exactly as im_error(3) but takes stdarg arguments.
44
45       im_error_system(3)  works  exactly as im_error(3) but additionally will
46       translate and append a system error code.
47
48       im_error_buffer(3) returns a pointer to the start of the error buffer.
49
50       im_error_clear(3) empties the error buffer.
51
52       error_exit(3) formats its arguments as printf and sends the  result  to
53       the  error  output, together with the contents of the error log, before
54       terminating with an error status.
55
56       im_warn(3) works as im_error(), but output is sent to the list of warn‐
57       ings.
58
59       If  an environment variable IM_WARNING exists, messages are suppressed.
60       Warnings should be used for non-critical  recoverable  errors  such  as
61       values being clipped.
62
63       im_diag(3) works as im_error(), but output is sent to the list of diag‐
64       nosic errors.
65
66       If an environment variable IM_DIAGNOSTICS  exists,  messages  are  sup‐
67       pressed.   Diagnostics  should be used to give extra feedback about the
68       result of the operation.
69

SEE ALSO

71       error_exit(3), im_intro(3).
72

74       Birkbeck College
75

AUTHOR

77       N. Dessipris - 22/04/1991
78
79
80
81                                 22 April 1991                  IM_ERRORMSG(3)
Impressum