logger

enregistreur

Bibliothèque d'utilitaires pour le traçage et le débogage du code source.

Pourrait être utilisé comme interface (en-tête uniquement) ou bibliothèque partagée.

Systèmes de build pris en charge

• CMake
• Bientôt AOSP

Éviers pris en charge

• std::cout - par défaut
• Android Logcat - si Android (AOSP et NDK)

Usage

Les deux exemples d'utilisation (en-tête uniquement ou bibliothèque partagée) peuvent être trouvés dans tests/LoggerMainTest.

Notes de bibliothèque de l'interface (en-tête uniquement)

1. Définissez la variable suivante dans votre code si elle utilise std::cout comme sortie de journalisation :

 std::mutex nlab::logger::gCoutMutex; // used for output synchronization

Sinon, désactivez la journalisation cout via la définition suivante : LOG_OUTPUT_COUT_DISABLED , par exemple pour CMake :

 add_definitions(-DLOG_OUTPUT_COUT_DISABLED`)

2. Pour la construction CMake, définissez l'option LOGGER_BUILD_HEADER_LIB=ON via la ligne de commande, par exemple :

 cmake -DCMAKE_BUILD_TYPE=Release -DLOGGER_BUILD_HEADER_LIB=ON ..

ou dans le fichier CMake du haut, par exemple :

 set(LOGGER_BUILD_HEADER_LIB ON CACHE BOOL "Build the header only library")
add_subdirectory(logger)

Exemples de résultats

Exemples de sorties capturées à partir de tests/LoggerMainTest

Pour la version de débogage :

 cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
cd tests
make
./LoggerMainTest

 06-26 17:23:21.897 [--->]  LoggerMainTest.cpp:16 main() ThreadId: 140718535841600
06-26 17:23:21.897 [--->]  LoggerMainTest.cpp:60 main_th() ThreadId: 140718515595008
06-26 17:23:21.897 [--->]  LoggerMainTest.cpp:60 main_th() ThreadId: 140718507202304
06-26 17:23:21.897 [--->]  LoggerMainTest.cpp:55 test2() ThreadId: 140718507202304
06-26 17:23:21.897 [--->]  LoggerMainTest.cpp:55 test2() ThreadId: 140718515595008
06-26 17:23:21.897 [<---]  LoggerMainTest.cpp:55 test2() ThreadId: 140718515595008
06-26 17:23:21.898 [<---]  LoggerMainTest.cpp:55 test2() ThreadId: 140718507202304
06-26 17:23:21.998 [--->]  LoggerMainTest.cpp:55 test2() ThreadId: 140718515595008
06-26 17:23:21.998 [<---]  LoggerMainTest.cpp:55 test2() ThreadId: 140718515595008
06-26 17:23:21.998 [--->]  LoggerMainTest.cpp:55 test2() ThreadId: 140718507202304
06-26 17:23:21.998 [<---]  LoggerMainTest.cpp:55 test2() ThreadId: 140718507202304
06-26 17:23:22.098 [--->]  LoggerMainTest.cpp:55 test2() ThreadId: 140718515595008
06-26 17:23:22.098 [<---]  LoggerMainTest.cpp:55 test2() ThreadId: 140718515595008
06-26 17:23:22.098 [--->]  LoggerMainTest.cpp:55 test2() ThreadId: 140718507202304
06-26 17:23:22.098 [<---]  LoggerMainTest.cpp:55 test2() ThreadId: 140718507202304
06-26 17:23:22.198 [<---]  LoggerMainTest.cpp:60 main_th() ThreadId: 140718515595008
06-26 17:23:22.198 [<---]  LoggerMainTest.cpp:60 main_th() ThreadId: 140718507202304
06-26 17:23:22.198 [info]  LoggerMainTest.cpp:24 main() Test Info 1
06-26 17:23:22.198 [warn]  LoggerMainTest.cpp:25 main() Test Warning 2
06-26 17:23:22.198 [error] LoggerMainTest.cpp:26 main() Test Error 3
06-26 17:23:22.198 [debug] LoggerMainTest.cpp:27 main() Test Debug 4
06-26 17:23:22.198 [info]  LoggerMainTest.cpp:30 main() Test 888 str c
06-26 17:23:22.199 [error] LoggerMainTest.cpp:33 main() ptr = nullptr
06-26 17:23:22.199 [--->]  LoggerMainTest.cpp:50 test1() ThreadId: 140718535841600
06-26 17:23:22.199 [<---]  LoggerMainTest.cpp:50 test1() ThreadId: 140718535841600
06-26 17:23:22.199 [--->]  LoggerMainTest.cpp:50 test1() ThreadId: 140718535841600
06-26 17:23:22.199 [<---]  LoggerMainTest.cpp:50 test1() ThreadId: 140718535841600
06-26 17:23:22.199 [--->]  LoggerMainTest.cpp:50 test1() ThreadId: 140718535841600
06-26 17:23:22.199 [<---]  LoggerMainTest.cpp:50 test1() ThreadId: 140718535841600
06-26 17:23:23.199 [<---]  LoggerMainTest.cpp:16 main() ThreadId: 140718535841600

Pour la version Release :

 cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cd tests
make
./LoggerMainTest

 06-26 17:37:00.411 [info]  LoggerMainTest.cpp:24 main() Test Info 1
06-26 17:37:00.411 [warn]  LoggerMainTest.cpp:25 main() Test Warning 2
06-26 17:37:00.411 [error] LoggerMainTest.cpp:26 main() Test Error 3
06-26 17:37:00.411 [info]  LoggerMainTest.cpp:30 main() Test 888 str c
06-26 17:37:00.411 [error] LoggerMainTest.cpp:33 main() ptr = nullptr