117 lines
3.3 KiB
C
117 lines
3.3 KiB
C
|
/*! \file exif-log.h
|
||
|
|
* \brief Log message infrastructure
|
||
|
|
*/
|
||
|
|
/*
|
||
|
|
* Copyright (c) 2004 Lutz Mueller <lutz@users.sourceforge.net>
|
||
|
|
*
|
||
|
|
* This library is free software; you can redistribute it and/or
|
||
|
|
* modify it under the terms of the GNU Lesser General Public
|
||
|
|
* License as published by the Free Software Foundation; either
|
||
|
|
* version 2 of the License, or (at your option) any later version.
|
||
|
|
*
|
||
|
|
* This library is distributed in the hope that it will be useful,
|
||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
|
|
* Lesser General Public License for more details.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU Lesser General Public
|
||
|
|
* License along with this library; if not, write to the
|
||
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
||
|
|
* Boston, MA 02110-1301 USA.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef __EXIF_LOG_H__
|
||
|
|
#define __EXIF_LOG_H__
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif /* __cplusplus */
|
||
|
|
|
||
|
|
#include <libexif/exif-mem.h>
|
||
|
|
#include <stdarg.h>
|
||
|
|
|
||
|
|
/*! State maintained by the logging interface */
|
||
|
|
typedef struct _ExifLog ExifLog;
|
||
|
|
|
||
|
|
/*! Create a new logging instance.
|
||
|
|
* \see exif_log_free
|
||
|
|
*
|
||
|
|
* \return new instance of #ExifLog
|
||
|
|
*/
|
||
|
|
ExifLog *exif_log_new (void);
|
||
|
|
ExifLog *exif_log_new_mem (ExifMem *);
|
||
|
|
void exif_log_ref (ExifLog *log);
|
||
|
|
void exif_log_unref (ExifLog *log);
|
||
|
|
|
||
|
|
/*! Delete instance of #ExifLog.
|
||
|
|
* \see exif_log_new
|
||
|
|
*
|
||
|
|
* \param[in] log #ExifLog
|
||
|
|
* \return new instance of #ExifLog
|
||
|
|
*/
|
||
|
|
void exif_log_free (ExifLog *log);
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
EXIF_LOG_CODE_NONE,
|
||
|
|
EXIF_LOG_CODE_DEBUG,
|
||
|
|
EXIF_LOG_CODE_NO_MEMORY,
|
||
|
|
EXIF_LOG_CODE_CORRUPT_DATA
|
||
|
|
} ExifLogCode;
|
||
|
|
|
||
|
|
/*! Return a textual description of the given class of error log.
|
||
|
|
*
|
||
|
|
* \param[in] code logging message class
|
||
|
|
* \return textual description of the log class
|
||
|
|
*/
|
||
|
|
const char *exif_log_code_get_title (ExifLogCode code);
|
||
|
|
|
||
|
|
/*! Return a verbose description of the given class of error log.
|
||
|
|
*
|
||
|
|
* \param[in] code logging message class
|
||
|
|
* \return verbose description of the log class
|
||
|
|
*/
|
||
|
|
const char *exif_log_code_get_message (ExifLogCode code);
|
||
|
|
|
||
|
|
/*! Log callback function prototype.
|
||
|
|
*/
|
||
|
|
typedef void (* ExifLogFunc) (ExifLog *log, ExifLogCode, const char *domain,
|
||
|
|
const char *format, va_list args, void *data);
|
||
|
|
|
||
|
|
/*! Register log callback function.
|
||
|
|
* Calls to the log callback function are purely for diagnostic purposes.
|
||
|
|
*
|
||
|
|
* \param[in] log logging state variable
|
||
|
|
* \param[in] func callback function to set
|
||
|
|
* \param[in] data data to pass into callback function
|
||
|
|
*/
|
||
|
|
void exif_log_set_func (ExifLog *log, ExifLogFunc func, void *data);
|
||
|
|
|
||
|
|
#ifndef NO_VERBOSE_TAG_STRINGS
|
||
|
|
void exif_log (ExifLog *log, ExifLogCode, const char *domain,
|
||
|
|
const char *format, ...)
|
||
|
|
#ifdef __GNUC__
|
||
|
|
__attribute__((__format__(printf,4,5)))
|
||
|
|
#endif
|
||
|
|
;
|
||
|
|
#else
|
||
|
|
#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
|
||
|
|
#define exif_log(...) do { } while (0)
|
||
|
|
#elif defined(__GNUC__)
|
||
|
|
#define exif_log(x...) do { } while (0)
|
||
|
|
#else
|
||
|
|
#define exif_log (void)
|
||
|
|
#endif
|
||
|
|
#endif
|
||
|
|
|
||
|
|
void exif_logv (ExifLog *log, ExifLogCode, const char *domain,
|
||
|
|
const char *format, va_list args);
|
||
|
|
|
||
|
|
/* For your convenience */
|
||
|
|
#define EXIF_LOG_NO_MEMORY(l,d,s) exif_log ((l), EXIF_LOG_CODE_NO_MEMORY, (d), "Could not allocate %lu byte(s).", (unsigned long)(s))
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif /* __cplusplus */
|
||
|
|
|
||
|
|
#endif /* __EXIF_LOG_H__ */
|