src/tiff/html/man/TIFFError.3tiff.html

   1 <!-- Creator     : groff version 1.18.1 -->
   2 <!-- CreationDate: Sat Feb 24 18:37:16 2007 -->
   3 <html>
   4 <head>
   5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   6 <meta name="Content-Style" content="text/css">
   7 <title>TIFFError</title>
   8 </head>
   9 <body>
  10
  11 <h1 align=center>TIFFError</h1>
  12 <a href="#NAME">NAME</a><br>
  13 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  14 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  15 <a href="#RETURN VALUES">RETURN VALUES</a><br>
  16 <a href="#SEE ALSO">SEE ALSO</a><br>
  17
  18 <hr>
  19 <a name="NAME"></a>
  20 <h2>NAME</h2>
  21 <!-- INDENTATION -->
  22 <table width="100%" border=0 rules="none" frame="void"
  23        cols="2" cellspacing="0" cellpadding="0">
  24 <tr valign="top" align="left">
  25 <td width="8%"></td>
  26 <td width="91%">
  27 <p>TIFFError, TIFFSetErrorHandler &minus; library error
  28 handling interface</p>
  29 </td>
  30 </table>
  31 <a name="SYNOPSIS"></a>
  32 <h2>SYNOPSIS</h2>
  33 <!-- INDENTATION -->
  34 <table width="100%" border=0 rules="none" frame="void"
  35        cols="2" cellspacing="0" cellpadding="0">
  36 <tr valign="top" align="left">
  37 <td width="8%"></td>
  38 <td width="91%">
  39 <p><b>#include &lt;tiffio.h&gt;</b></p>
  40 <!-- INDENTATION -->
  41 <p><b>void TIFFError(const char *</b><i>module</i><b>, const
  42 char *</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p>
  43 <!-- INDENTATION -->
  44 <p><b>#include &lt;stdarg.h&gt;</b></p>
  45 <!-- INDENTATION -->
  46 <p><b>typedef void (*TIFFErrorHandler)(const char
  47 *</b><i>module</i><b>, const char *</b><i>fmt</i><b>,
  48 va_list</b> <i>ap</i><b>);<br>
  49 TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler
  50 handler);</b></p>
  51 </td>
  52 </table>
  53 <a name="DESCRIPTION"></a>
  54 <h2>DESCRIPTION</h2>
  55 <!-- INDENTATION -->
  56 <table width="100%" border=0 rules="none" frame="void"
  57        cols="2" cellspacing="0" cellpadding="0">
  58 <tr valign="top" align="left">
  59 <td width="8%"></td>
  60 <td width="91%">
  61 <p><i>TIFFError</i> invokes the library-wide error handling
  62 function to (normally) write an error message to the
  63 <b>stderr</b>. The <i>fmt</i> parameter is a
  64 <i>printf</i>(3S) format string, and any number arguments
  65 can be supplied. The <i>module</i> parameter, if non-zero,
  66 is printed before the message; it typically is used to
  67 identify the software module in which an error is
  68 detected.</p>
  69 <!-- INDENTATION -->
  70 <p>Applications that desire to capture control in the event
  71 of an error should use <i>TIFFSetErrorHandler</i> to
  72 override the default error handler. A <small>NULL</small>
  73 (0) error handling function may be installed to suppress
  74 error messages.</p>
  75 </td>
  76 </table>
  77 <a name="RETURN VALUES"></a>
  78 <h2>RETURN VALUES</h2>
  79 <!-- INDENTATION -->
  80 <table width="100%" border=0 rules="none" frame="void"
  81        cols="2" cellspacing="0" cellpadding="0">
  82 <tr valign="top" align="left">
  83 <td width="8%"></td>
  84 <td width="91%">
  85 <p><i>TIFFSetErrorHandler</i> returns a reference to the
  86 previous error handling function.</p>
  87 </td>
  88 </table>
  89 <a name="SEE ALSO"></a>
  90 <h2>SEE ALSO</h2>
  91 <!-- INDENTATION -->
  92 <table width="100%" border=0 rules="none" frame="void"
  93        cols="2" cellspacing="0" cellpadding="0">
  94 <tr valign="top" align="left">
  95 <td width="8%"></td>
  96 <td width="91%">
  97 <p><b>TIFFWarning</b>(3TIFF), <b>libtiff</b>(3TIFF),
  98 <b>printf</b>(3)</p>
  99 <!-- INDENTATION -->
 100 <p>Libtiff library home page:
 101 <b>http://www.remotesensing.org/libtiff/</b></p>
 102 </td>
 103 </table>
 104 <hr>
 105 </body>
 106 </html>