Current Directory: /usr/share/doc/libtiff-devel/html/man
Viewing File: /usr/share/doc/libtiff-devel/html/man/TIFFError.3tiff.html
<!-- Creator : groff version 1.22.4 -->
<!-- CreationDate: Sun Nov 2 19:00:00 2025 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>TIFFError</title>
</head>
<body>
<h1 align="center">TIFFError</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#RETURN VALUES">RETURN VALUES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">TIFFError,
TIFFSetErrorHandler − library error handling
interface</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>#include
<tiffio.h></b></p>
<p style="margin-left:11%; margin-top: 1em"><b>void
TIFFError(const char *</b><i>module</i><b>, const char
*</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>#include
<stdarg.h></b></p>
<p style="margin-left:11%; margin-top: 1em"><b>typedef void
(*TIFFErrorHandler)(const char *</b><i>module</i><b>, const
char *</b><i>fmt</i><b>, va_list</b> <i>ap</i><b>); <br>
TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler
handler);</b></p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b><i>TIFFError</i></b>
invokes the library-wide error handling function to
(normally) write an error message to the <b>stderr</b>. The
<i>fmt</i> parameter is a <i>printf</i>(3S) format string,
and any number arguments can be supplied. The <i>module</i>
parameter, if non-zero, is printed before the message; it
typically is used to identify the software module in which
an error is detected.</p>
<p style="margin-left:11%; margin-top: 1em">Applications
that desire to capture control in the event of an error
should use <i>TIFFSetErrorHandler</i> to override the
default error handler. A <small>NULL</small> (0) error
handling function may be installed to suppress error
messages.</p>
<p style="margin-left:11%; margin-top: 1em">Please refer to
<i>TIFFOpenOptions</i> for how to setup the
application-specific handler introduced with libtiff
4.5.</p>
<h2>RETURN VALUES
<a name="RETURN VALUES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><i>TIFFSetErrorHandler</i>
returns a reference to the previous error handling
function.</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>TIFFWarning</b>(3TIFF),
<b>libtiff</b>(3TIFF), <b>printf</b>(3)</p>
<p style="margin-left:11%; margin-top: 1em">Libtiff library
home page: <b>http://www.simplesystems.org/libtiff/</b></p>
<hr>
</body>
</html>