mirror of
https://github.com/gabime/spdlog.git
synced 2024-11-16 08:55:46 +08:00
344 lines
9.9 KiB
C++
344 lines
9.9 KiB
C++
// Copyright(c) 2015-present, Gabi Melman & spdlog contributors.
|
|
// Distributed under the MIT License (http://opensource.org/licenses/MIT)
|
|
|
|
// spdlog main header file.
|
|
// see example.cpp for usage example
|
|
|
|
#ifndef SPDLOG_H
|
|
#define SPDLOG_H
|
|
|
|
#pragma once
|
|
|
|
#include "spdlog/common.h"
|
|
#include "spdlog/details/registry.h"
|
|
#include "spdlog/logger.h"
|
|
#include "spdlog/version.h"
|
|
#include "spdlog/details/synchronous_factory.h"
|
|
|
|
#include <chrono>
|
|
#include <functional>
|
|
#include <memory>
|
|
#include <string>
|
|
|
|
namespace spdlog {
|
|
|
|
using default_factory = synchronous_factory;
|
|
|
|
// Create and register a logger with a templated sink type
|
|
// The logger's level, formatter and flush level will be set according the
|
|
// global settings.
|
|
//
|
|
// Example:
|
|
// spdlog::create<daily_file_sink_st>("logger_name", "dailylog_filename", 11, 59);
|
|
template<typename Sink, typename... SinkArgs>
|
|
inline std::shared_ptr<spdlog::logger> create(std::string logger_name, SinkArgs &&... sink_args)
|
|
{
|
|
return default_factory::create<Sink>(std::move(logger_name), std::forward<SinkArgs>(sink_args)...);
|
|
}
|
|
|
|
// Initialize and register a logger,
|
|
// formatter and flush level will be set according the global settings.
|
|
//
|
|
// NOTE:
|
|
// Use this function when creating loggers manually.
|
|
//
|
|
// Example:
|
|
// auto console_sink = std::make_shared<spdlog::sinks::stdout_sink_mt>();
|
|
// auto console_logger = std::make_shared<spdlog::logger>("console_logger", console_sink);
|
|
// spdlog::initialize_logger(console_logger);
|
|
void initialize_logger(std::shared_ptr<logger> logger);
|
|
|
|
// Return an existing logger or nullptr if a logger with such name doesn't
|
|
// exist.
|
|
// example: spdlog::get("my_logger")->info("hello {}", "world");
|
|
std::shared_ptr<logger> get(const std::string &name);
|
|
|
|
// Set global formatter. Each sink in each logger will get a clone of this object
|
|
void set_formatter(std::unique_ptr<spdlog::formatter> formatter);
|
|
|
|
// Set global format string.
|
|
// example: spdlog::set_pattern("%Y-%m-%d %H:%M:%S.%e %l : %v");
|
|
void set_pattern(std::string pattern, pattern_time_type time_type = pattern_time_type::local);
|
|
|
|
// enable global backtrace support
|
|
void enable_backtrace(size_t n_messages);
|
|
|
|
// disable global backtrace support
|
|
void disable_backtrace();
|
|
|
|
// call dump backtrace on default logger
|
|
void dump_backtrace();
|
|
|
|
// Set global logging level
|
|
void set_level(level::level_enum log_level);
|
|
|
|
// Set global flush level
|
|
void flush_on(level::level_enum log_level);
|
|
|
|
// Start/Restart a periodic flusher thread
|
|
// Warning: Use only if all your loggers are thread safe!
|
|
void flush_every(std::chrono::seconds interval);
|
|
|
|
// Set global error handler
|
|
void set_error_handler(void (*handler)(const std::string &msg));
|
|
|
|
// Register the given logger with the given name
|
|
void register_logger(std::shared_ptr<logger> logger);
|
|
|
|
// Apply a user defined function on all registered loggers
|
|
// Example:
|
|
// spdlog::apply_all([&](std::shared_ptr<spdlog::logger> l) {l->flush();});
|
|
void apply_all(const std::function<void(std::shared_ptr<logger>)> &fun);
|
|
|
|
// Drop the reference to the given logger
|
|
void drop(const std::string &name);
|
|
|
|
// Drop all references from the registry
|
|
void drop_all();
|
|
|
|
// stop any running threads started by spdlog and clean registry loggers
|
|
void shutdown();
|
|
|
|
// Automatic registration of loggers when using spdlog::create() or spdlog::create_async
|
|
void set_automatic_registration(bool automatic_registation);
|
|
|
|
// API for using default logger (stdout_color_mt),
|
|
// e.g: spdlog::info("Message {}", 1);
|
|
//
|
|
// The default logger object can be accessed using the spdlog::default_logger():
|
|
// For example, to add another sink to it:
|
|
// spdlog::default_logger()->sinks()->push_back(some_sink);
|
|
//
|
|
// The default logger can replaced using spdlog::set_default_logger(new_logger).
|
|
// For example, to replace it with a file logger.
|
|
//
|
|
// IMPORTANT:
|
|
// The default API is thread safe (for _mt loggers), but:
|
|
// set_default_logger() *should not* be used concurrently with the default API.
|
|
// e.g do not call set_default_logger() from one thread while calling spdlog::info() from another.
|
|
|
|
std::shared_ptr<spdlog::logger> default_logger();
|
|
|
|
spdlog::logger *default_logger_raw();
|
|
|
|
void set_default_logger(std::shared_ptr<spdlog::logger> default_logger);
|
|
|
|
template<typename... Args>
|
|
inline void log(source_loc source, level::level_enum lvl, string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->log(source, lvl, fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void log(level::level_enum lvl, string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->log(source_loc{}, lvl, fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void trace(string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->trace(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void debug(string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->debug(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void info(string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->info(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void warn(string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->warn(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void error(string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->error(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void critical(string_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->critical(fmt, args...);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void log(source_loc source, level::level_enum lvl, const T &msg)
|
|
{
|
|
default_logger_raw()->log(source, lvl, msg);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void log(level::level_enum lvl, const T &msg)
|
|
{
|
|
default_logger_raw()->log(lvl, msg);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void trace(const T &msg)
|
|
{
|
|
default_logger_raw()->trace(msg);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void debug(const T &msg)
|
|
{
|
|
default_logger_raw()->debug(msg);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void info(const T &msg)
|
|
{
|
|
default_logger_raw()->info(msg);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void warn(const T &msg)
|
|
{
|
|
default_logger_raw()->warn(msg);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void error(const T &msg)
|
|
{
|
|
default_logger_raw()->error(msg);
|
|
}
|
|
|
|
template<typename T>
|
|
inline void critical(const T &msg)
|
|
{
|
|
default_logger_raw()->critical(msg);
|
|
}
|
|
|
|
#ifdef SPDLOG_WCHAR_TO_UTF8_SUPPORT
|
|
template<typename... Args>
|
|
inline void log(source_loc source, level::level_enum lvl, wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->log(source, lvl, fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void log(level::level_enum lvl, wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->log(lvl, fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void trace(wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->trace(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void debug(wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->debug(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void info(wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->info(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void warn(wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->warn(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void error(wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->error(fmt, args...);
|
|
}
|
|
|
|
template<typename... Args>
|
|
inline void critical(wstring_view_t fmt, const Args &... args)
|
|
{
|
|
default_logger_raw()->critical(fmt, args...);
|
|
}
|
|
|
|
#endif // SPDLOG_WCHAR_TO_UTF8_SUPPORT
|
|
|
|
} // namespace spdlog
|
|
|
|
//
|
|
// enable/disable log calls at compile time according to global level.
|
|
//
|
|
// define SPDLOG_ACTIVE_LEVEL to one of those (before including spdlog.h):
|
|
// SPDLOG_LEVEL_TRACE,
|
|
// SPDLOG_LEVEL_DEBUG,
|
|
// SPDLOG_LEVEL_INFO,
|
|
// SPDLOG_LEVEL_WARN,
|
|
// SPDLOG_LEVEL_ERROR,
|
|
// SPDLOG_LEVEL_CRITICAL,
|
|
// SPDLOG_LEVEL_OFF
|
|
//
|
|
|
|
#define SPDLOG_LOGGER_CALL(logger, level, ...)\
|
|
logger->log(spdlog::source_loc{__FILE__, __LINE__, SPDLOG_FUNCTION}, level, __VA_ARGS__); \
|
|
|
|
#if SPDLOG_ACTIVE_LEVEL <= SPDLOG_LEVEL_TRACE
|
|
#define SPDLOG_LOGGER_TRACE(logger, ...) SPDLOG_LOGGER_CALL(logger, spdlog::level::trace, __VA_ARGS__)
|
|
#define SPDLOG_TRACE(...) SPDLOG_LOGGER_TRACE(spdlog::default_logger_raw(), __VA_ARGS__)
|
|
#else
|
|
#define SPDLOG_LOGGER_TRACE(logger, ...) (void)0
|
|
#define SPDLOG_TRACE(...) (void)0
|
|
#endif
|
|
|
|
#if SPDLOG_ACTIVE_LEVEL <= SPDLOG_LEVEL_DEBUG
|
|
#define SPDLOG_LOGGER_DEBUG(logger, ...) SPDLOG_LOGGER_CALL(logger, spdlog::level::debug, __VA_ARGS__)
|
|
#define SPDLOG_DEBUG(...) SPDLOG_LOGGER_DEBUG(spdlog::default_logger_raw(), __VA_ARGS__)
|
|
#else
|
|
#define SPDLOG_LOGGER_DEBUG(logger, ...) (void)0
|
|
#define SPDLOG_DEBUG(...) (void)0
|
|
#endif
|
|
|
|
#if SPDLOG_ACTIVE_LEVEL <= SPDLOG_LEVEL_INFO
|
|
#define SPDLOG_LOGGER_INFO(logger, ...) SPDLOG_LOGGER_CALL(logger, spdlog::level::info, __VA_ARGS__)
|
|
#define SPDLOG_INFO(...) SPDLOG_LOGGER_INFO(spdlog::default_logger_raw(), __VA_ARGS__)
|
|
#else
|
|
#define SPDLOG_LOGGER_INFO(logger, ...) (void)0
|
|
#define SPDLOG_INFO(...) (void)0
|
|
#endif
|
|
|
|
#if SPDLOG_ACTIVE_LEVEL <= SPDLOG_LEVEL_WARN
|
|
#define SPDLOG_LOGGER_WARN(logger, ...) SPDLOG_LOGGER_CALL(logger, spdlog::level::warn, __VA_ARGS__)
|
|
#define SPDLOG_WARN(...) SPDLOG_LOGGER_WARN(spdlog::default_logger_raw(), __VA_ARGS__)
|
|
#else
|
|
#define SPDLOG_LOGGER_WARN(logger, ...) (void)0
|
|
#define SPDLOG_WARN(...) (void)0
|
|
#endif
|
|
|
|
#if SPDLOG_ACTIVE_LEVEL <= SPDLOG_LEVEL_ERROR
|
|
#define SPDLOG_LOGGER_ERROR(logger, ...) SPDLOG_LOGGER_CALL(logger, spdlog::level::err, __VA_ARGS__)
|
|
#define SPDLOG_ERROR(...) SPDLOG_LOGGER_ERROR(spdlog::default_logger_raw(), __VA_ARGS__)
|
|
#else
|
|
#define SPDLOG_LOGGER_ERROR(logger, ...) (void)0
|
|
#define SPDLOG_ERROR(...) (void)0
|
|
#endif
|
|
|
|
#if SPDLOG_ACTIVE_LEVEL <= SPDLOG_LEVEL_CRITICAL
|
|
#define SPDLOG_LOGGER_CRITICAL(logger, ...) SPDLOG_LOGGER_CALL(logger, spdlog::level::critical, __VA_ARGS__)
|
|
#define SPDLOG_CRITICAL(...) SPDLOG_LOGGER_CRITICAL(spdlog::default_logger_raw(), __VA_ARGS__)
|
|
#else
|
|
#define SPDLOG_LOGGER_CRITICAL(logger, ...) (void)0
|
|
#define SPDLOG_CRITICAL(...) (void)0
|
|
#endif
|
|
|
|
#ifdef SPDLOG_HEADER_ONLY
|
|
#include "spdlog-inl.h"
|
|
#endif
|
|
|
|
#endif // SPDLOG_H
|