<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_ERRORMSG(3) manual page</title> </head> <body bgcolor='white'> <a href='#toc'>Table of Contents</a><p> <h2><a name='sect0' href='#toc0'>Name</a></h2> im_error_buffer, im_verror, im_error, im_error_clear, im_warn, im_diag, error_exit - handle error messages from VIPS <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>#include <vips/vips.h></b> <p> <b>const char *im_error_buffer( void )</b> <p> <b>void im_verror( const char *domain, const char *fmt, va_list ap )</b> <p> <b>void im_error( const char *domain, const char *fmt, ... )</b> <p> <b>void im_error_system( int errno, const char *domain, const char *fmt, ... )</b> <p> <b>void im_error_clear()</b> <p> <b>void im_warn( const char *domain, const char *fmt, ... )</b> <p> <b>void im_diag( const char *domain, const char *fmt, ... )</b> <p> <b>void error_exit( const char *fmt, ... )</b> <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> <a href='im_error.3.html'><b>im_error(3)</b></a> formats its arguments as printf and appends the string, with a newline, to the error buffer. The <b>domain</b> argument indicates the error source and should not be marked for translation. <p> For example, the call: <p> im_error( "mystuff", _( "bad argument %d" ), a );<br> <p> might appear in the error buffer as: <p> mystuff: bad argument 12<br> <p> <a href='im_verror.3.html'><b>im_verror(3)</b></a> works exactly as <a href='im_error.3.html'><b>im_error(3)</b></a> but takes stdarg arguments. <p> <a href='im_error_system.3.html'><b>im_error_system(3)</b></a> works exactly as <a href='im_error.3.html'><b>im_error(3)</b></a> but additionally will translate and append a system error code. <p> <a href='im_error_buffer.3.html'><b>im_error_buffer(3)</b></a> returns a pointer to the start of the error buffer. <p> <a href='im_error_clear.3.html'><b>im_error_clear(3)</b></a> empties the error buffer. <p> <a href='error_exit.3.html'><b>error_exit(3)</a> </b> 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. <p> <a href='im_warn.3.html'><b>im_warn(3)</b></a> works as <b>im_error(), </b> but output is sent to the list of warnings. <p> If an environment variable IM_WARNING exists, messages are suppressed. Warnings should be used for non-critical recoverable errors such as values being clipped. <p> <a href='im_diag.3.html'><b>im_diag(3)</b></a> works as <b>im_error(), </b> but output is sent to the list of diagnosic errors. <p> If an environment variable IM_DIAGNOSTICS exists, messages are suppressed. Diagnostics should be used to give extra feedback about the result of the operation. <h2><a name='sect3' href='#toc3'>See Also</a></h2> <a href='error_exit.3.html'>error_exit(3)</a> , <a href='im_intro.3.html'>im_intro(3)</a> . <h2><a name='sect4' href='#toc4'>Copyright</a></h2> <br> Birkbeck College <h2><a name='sect5' href='#toc5'>Author</a></h2> N. Dessipris - 22/04/1991 <p> <hr><p> <a name='toc'><b>Table of Contents</b></a><p> <ul> <li><a name='toc0' href='#sect0'>Name</a></li> <li><a name='toc1' href='#sect1'>Synopsis</a></li> <li><a name='toc2' href='#sect2'>Description</a></li> <li><a name='toc3' href='#sect3'>See Also</a></li> <li><a name='toc4' href='#sect4'>Copyright</a></li> <li><a name='toc5' href='#sect5'>Author</a></li> </ul> </body> </html>