log.h

Go to the documentation of this file.

/* Copyright (C) 2015-2017 Chris Piker <chris-piker@uiowa.edu>
 *
 * This file is part of das2C, the Core Das2 C Library.
 * 
 * Das2C is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 2.1 as published
 * by the Free Software Foundation.
 *
 * Das2C 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
 * version 2.1 along with das2C; if not, see <http://www.gnu.org/licenses/>. 
 */
 
 
/* Ported over from librpwgse which was laboriously developed for Juno Waves
 * support.  Since logging is much different then just failing with an
 * error, this is a different facility than the das_error_func from util.h
 * but the two items have common functionality that should be merged over time.
 * -cwp 2016-10-20 
 */
 
#ifndef _das_log_h_
#define _das_log_h_
 
#include <das3/util.h>
 
#ifdef __cplusplus
extern "C" {
#endif
   
#define DASLOG_NOTHING 255
#define DASLOG_CRIT   100  /* same as java.util.logging.Level.SEVERE */
#define DASLOG_ERROR   80  
#define DASLOG_WARN    60  /* same as java.util.logging.Level.WARNING */
#define DASLOG_INFO    40  /* same as java.util.logging.Level.INFO & CONFIG */
#define DASLOG_DEBUG   20  /* same as java.util.logging.Level.FINE */
#define DASLOG_TRACE    0  /* same as java.util.logging.Level.FINER & FINEST */
 
DAS_API int daslog_level(void);
 
DAS_API int daslog_setlevel(int nLevel);
 
DAS_API int daslog_strlevel(const char* sLevel);
 
DAS_API const char* daslog_levelstr(int nLevel);
 
DAS_API bool daslog_set_showline(int nLevel);
 
 
/* Basic logging function, macros use this */
DAS_API void daslog(int nLevel, const char* sSrcFile, int nLine, const char* sFmt, ...)
   _das_fmt_check(4, 5);
 
      
#define daslog_trace(M) daslog(DASLOG_TRACE, __FILE__, __LINE__, M)
#define daslog_debug(M) daslog(DASLOG_DEBUG, __FILE__, __LINE__, M)
#define daslog_info(M) daslog(DASLOG_INFO, __FILE__, __LINE__, M) 
#define daslog_warn(M) daslog(DASLOG_WARN, __FILE__, __LINE__, M) 
#define daslog_error(M) daslog(DASLOG_ERROR, __FILE__, __LINE__, M) 
#define daslog_critical(M) daslog(DASLOG_CRIT, __FILE__, __LINE__, M)
 
 
#define daslog_trace_v(F, ...)\
  daslog(DASLOG_TRACE, __FILE__, __LINE__, F, __VA_ARGS__)
#define daslog_debug_v(F, ...)\
  daslog(DASLOG_DEBUG, __FILE__, __LINE__, F, __VA_ARGS__)
#define daslog_info_v(F, ...)\
  daslog(DASLOG_INFO, __FILE__, __LINE__, F, __VA_ARGS__) 
#define daslog_warn_v(F, ...)\
  daslog(DASLOG_WARN, __FILE__, __LINE__, F, __VA_ARGS__) 
#define daslog_error_v(F, ...)\
  daslog(DASLOG_ERROR, __FILE__, __LINE__, F, __VA_ARGS__) 
#define daslog_critical_v(F, ...)\
  daslog(DASLOG_CRIT, __FILE__, __LINE__, F, __VA_ARGS__)
 
 
DAS_API das_log_handler_t daslog_sethandler(das_log_handler_t new_handler);
 
#ifdef __cplusplus
}
#endif
 
#endif /* _das_log_h_ */