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
28handling 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
42char *</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>,
48va_list</b> <i>ap</i><b>);<br>
49TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler
50handler);</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
62function 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
65can be supplied. The <i>module</i> parameter, if non-zero,
66is printed before the message; it typically is used to
67identify the software module in which an error is
68detected.</p>
69<!-- INDENTATION -->
70<p>Applications that desire to capture control in the event
71of an error should use <i>TIFFSetErrorHandler</i> to
72override the default error handler. A <small>NULL</small>
73(0) error handling function may be installed to suppress
74error 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
86previous 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.simplesystems.org/libtiff/</b></p>
102</td>
103</table>
104<hr>
105</body>
106</html>
107