mirror of https://github.com/gabime/spdlog.git
readme
gabime
11 years ago
parent
e8403e17df
commit
74aae4f368
@ -0,0 +1,13 @@
|
|||||||
|
spdlog is header only library.
|
||||||
|
Just copy the files to your build tree and use a C++11 compiler
|
||||||
|
|
||||||
|
Tested on:
|
||||||
|
gcc 4.8.1 and above
|
||||||
|
clang 3.5
|
||||||
|
Visual Studio 2013
|
||||||
|
|
||||||
|
gcc 4.8 flags: --std==c++11 -pthread -O3 -flto -Wl,--no-as-needed
|
||||||
|
gcc 4.9 flags: --std=c++11 -pthread -O3 -flto
|
||||||
|
|
||||||
|
|
||||||
|
see the makefile in the example folder
|
||||||
@ -0,0 +1,23 @@
|
|||||||
|
/*************************************************************************/
|
||||||
|
/* spdlog - an extremely fast and easy to use c++11 logging library. */
|
||||||
|
/* Copyright (c) 2014 Gabi Melman. */
|
||||||
|
/* */
|
||||||
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
||||||
|
/* a copy of this software and associated documentation files (the */
|
||||||
|
/* "Software"), to deal in the Software without restriction, including */
|
||||||
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
||||||
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
||||||
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
||||||
|
/* the following conditions: */
|
||||||
|
/* */
|
||||||
|
/* The above copyright notice and this permission notice shall be */
|
||||||
|
/* included in all copies or substantial portions of the Software. */
|
||||||
|
/* */
|
||||||
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
||||||
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
||||||
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
||||||
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
||||||
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
||||||
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
||||||
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
||||||
|
/*************************************************************************/
|
||||||
@ -0,0 +1,82 @@
|
|||||||
|
# spdlog
|
||||||
|
|
||||||
|
spdlog is very fast, header only, c++11 logging library.
|
||||||
|
|
||||||
|
|
||||||
|
## Install
|
||||||
|
Just copy the files to your build tree and use a C++11 compiler
|
||||||
|
|
||||||
|
|
||||||
|
## Tested on:
|
||||||
|
* gcc 4.8.1 and above
|
||||||
|
* clang 3.5
|
||||||
|
* visual studio 2013
|
||||||
|
|
||||||
|
##Features
|
||||||
|
* Stream like, east to use interface
|
||||||
|
* Logging levels
|
||||||
|
* Rotating log files
|
||||||
|
* Daily log files
|
||||||
|
* Async logging
|
||||||
|
* Thread safety
|
||||||
|
* Very low overhead
|
||||||
|
|
||||||
|
## Performance
|
||||||
|
The library is very fast.
|
||||||
|
Here are some benchmarks (Ubuntu, Intel(R) Core(TM) i7-4770 CPU @ 3.40GHz)
|
||||||
|
```
|
||||||
|
*******************************************************************************
|
||||||
|
Single thread, 250,000 iterations, flush every 1000 lines
|
||||||
|
*******************************************************************************
|
||||||
|
rotating_st... 817,860 lines/sec
|
||||||
|
daily_st... 827,820 lines /sec
|
||||||
|
|
||||||
|
*******************************************************************************
|
||||||
|
4 threads sharing same logger, 250,000 iterations, flush every 1000 lines
|
||||||
|
*******************************************************************************
|
||||||
|
rotating_mt... 1,476,013 lines/sec
|
||||||
|
daily_mt... 1,477,619 lines/sec
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage Example
|
||||||
|
```
|
||||||
|
#include <iostream>
|
||||||
|
#include "spdlog/spdlog.h"
|
||||||
|
|
||||||
|
int main(int, char* [])
|
||||||
|
{
|
||||||
|
namespace spd = spdlog;
|
||||||
|
|
||||||
|
try
|
||||||
|
{
|
||||||
|
std::string filename = "spdlog_example";
|
||||||
|
auto console = spd::stderr_logger_mt("console");
|
||||||
|
console->info("Welcome to spdlog!") ;
|
||||||
|
console->info() << "Creating file " << filename << "..";
|
||||||
|
|
||||||
|
auto file_logger = spd::rotating_logger_mt("file_logger", filename, 1024 * 1024 * 5, 3);
|
||||||
|
file_logger->info("Log file message number", 1);
|
||||||
|
|
||||||
|
for (int i = 0; i < 100; ++i)
|
||||||
|
{
|
||||||
|
auto square = i*i;
|
||||||
|
file_logger->info() << i << '*' << i << '=' << square << " (" << "0x" << std::hex << square << ")";
|
||||||
|
}
|
||||||
|
|
||||||
|
// Change log level to all loggers to warning and above
|
||||||
|
spd::set_level(spd::level::WARN);
|
||||||
|
console->info("This should not be displayed");
|
||||||
|
console->warn("This should!");
|
||||||
|
spd::set_level(spd::level::INFO);
|
||||||
|
|
||||||
|
// Change format pattern to all loggers
|
||||||
|
spd::set_pattern(" **** %Y-%m-%d %H:%M:%S.%e %l **** %v");
|
||||||
|
spd::get("console")->info("This is another message with different format");
|
||||||
|
}
|
||||||
|
catch (const spd::spdlog_ex& ex)
|
||||||
|
{
|
||||||
|
std::cout << "Log failed: " << ex.what() << std::endl;
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
```
|
||||||
@ -1,37 +0,0 @@
|
|||||||
========================================================================
|
|
||||||
STATIC LIBRARY : c11log Project Overview
|
|
||||||
========================================================================
|
|
||||||
|
|
||||||
AppWizard has created this c11log library project for you.
|
|
||||||
|
|
||||||
This file contains a summary of what you will find in each of the files that
|
|
||||||
make up your c11log application.
|
|
||||||
|
|
||||||
|
|
||||||
c11log.vcxproj
|
|
||||||
This is the main project file for VC++ projects generated using an Application Wizard.
|
|
||||||
It contains information about the version of Visual C++ that generated the file, and
|
|
||||||
information about the platforms, configurations, and project features selected with the
|
|
||||||
Application Wizard.
|
|
||||||
|
|
||||||
c11log.vcxproj.filters
|
|
||||||
This is the filters file for VC++ projects generated using an Application Wizard.
|
|
||||||
It contains information about the association between the files in your project
|
|
||||||
and the filters. This association is used in the IDE to show grouping of files with
|
|
||||||
similar extensions under a specific node (for e.g. ".cpp" files are associated with the
|
|
||||||
"Source Files" filter).
|
|
||||||
|
|
||||||
|
|
||||||
/////////////////////////////////////////////////////////////////////////////
|
|
||||||
|
|
||||||
StdAfx.h, StdAfx.cpp
|
|
||||||
These files are used to build a precompiled header (PCH) file
|
|
||||||
named c11log.pch and a precompiled types file named StdAfx.obj.
|
|
||||||
|
|
||||||
/////////////////////////////////////////////////////////////////////////////
|
|
||||||
Other notes:
|
|
||||||
|
|
||||||
AppWizard uses "TODO:" comments to indicate parts of the source code you
|
|
||||||
should add to or customize.
|
|
||||||
|
|
||||||
/////////////////////////////////////////////////////////////////////////////
|
|
||||||
Loading…
Reference in New Issue