TIFFWarning (3)

Leading comments

$Id: TIFFWarning.3tiff,v 1.4 2016-09-25 20:05:50 bfriesen Exp $

Copyright (c) 1988-1997 Sam Leffler
Copyright (c) 1991-1997 Silicon Graphics, Inc.

Permission to use, copy, modify, distribute, and sell this software and
its documentation for any purpose is hereby granted without fee, provided
that (i) the above copyright notices and this permission notice appear in
all copies of the software and related documentation, and (ii) the names of
Sam Leffler and Silicon Graphics may not be used in ...

(The comments found at the beginning of the groff file "man3/TIFFWarning.3tiff".)

NAME

TIFFWarning, TIFFSetWarningHandler - library warning interface

SYNOPSIS

#include <tiffio.h>

void TIFFWarning(const char *module, const char *fmt, ...)

#include <stdarg.h>

typedef void (*TIFFWarningHandler)(const char *module, const char *fmt, va_list ap);

TIFFWarningHandler TIFFSetWarningHandler(TIFFWarningHandler handler);

DESCRIPTION

TIFFWarning invokes the library-wide warning handler function to (normally) write a warning message to the stderr. The fmt parameter is a printf(3S) format string, and any number arguments can be supplied. The module parameter is interpreted as a string that, if non-zero, should be printed before the message; it typically is used to identify the software module in which a warning is detected.

Applications that desire to capture control in the event of a warning should use TIFFSetWarningHandler to override the default warning handler. A

(0) warning handler function may be installed to suppress error messages.

RETURN VALUES

TIFFSetWarningHandler returns a reference to the previous error handling function.

SEE ALSO

TIFFError(3TIFF), libtiff(3TIFF), printf(3)

Libtiff library home page: www.simplesystems.org/libtiff