SDL3pp
A slim C++ wrapper for SDL3
Loading...
Searching...
No Matches
SDL3pp_log.h
1#ifndef SDL3PP_LOG_H_
2#define SDL3PP_LOG_H_
3
4#include <format>
5#include <SDL3/SDL_log.h>
6#include "SDL3pp_callbackWrapper.h"
7#include "SDL3pp_error.h"
8#include "SDL3pp_strings.h"
9
10namespace SDL {
11
63using LogCategoryRaw = SDL_LogCategory;
64
65// Forward decl
66struct LogCategory;
67
81using LogPriority = SDL_LogPriority;
82
84 SDL_LOG_PRIORITY_INVALID;
85
86constexpr LogPriority LOG_PRIORITY_TRACE = SDL_LOG_PRIORITY_TRACE;
87
89 SDL_LOG_PRIORITY_VERBOSE;
90
91constexpr LogPriority LOG_PRIORITY_DEBUG = SDL_LOG_PRIORITY_DEBUG;
92
93constexpr LogPriority LOG_PRIORITY_INFO = SDL_LOG_PRIORITY_INFO;
94
95constexpr LogPriority LOG_PRIORITY_WARN = SDL_LOG_PRIORITY_WARN;
96
97constexpr LogPriority LOG_PRIORITY_ERROR = SDL_LOG_PRIORITY_ERROR;
98
100 SDL_LOG_PRIORITY_CRITICAL;
101
102constexpr LogPriority LOG_PRIORITY_COUNT = SDL_LOG_PRIORITY_COUNT;
103
105
128{
129 LogCategoryRaw m_category;
130
131public:
137 constexpr LogCategory(LogCategoryRaw category = SDL_LOG_CATEGORY_APPLICATION)
138 : m_category(category)
139 {
140 }
141
147 constexpr explicit LogCategory(int category)
148 : m_category(SDL_LogCategory(category))
149 {
150 }
151
157 constexpr operator LogCategoryRaw() const { return m_category; }
158
172 void SetLogPriority(LogPriority priority) const;
173
186
207 void LogUnformatted(LogPriority priority, StringParam message) const
208 {
209 SDL_LogMessage(m_category, priority, "%s", (const char*)(message));
210 }
211
237 template<class... ARGS>
238 void LogMessage(LogPriority priority,
239 std::string_view fmt,
240 ARGS... args) const;
241
266 template<class... ARGS>
267 void LogTrace(std::string_view fmt, ARGS&&... args) const;
268
292 template<class... ARGS>
293 void LogVerbose(std::string_view fmt, ARGS&&... args) const;
294
319 template<class... ARGS>
320 void LogDebug(std::string_view fmt, ARGS&&... args) const;
321
346 template<class... ARGS>
347 void LogInfo(std::string_view fmt, ARGS&&... args) const;
348
373 template<class... ARGS>
374 void LogWarn(std::string_view fmt, ARGS&&... args) const;
375
400 template<class... ARGS>
401 void LogError(std::string_view fmt, ARGS&&... args) const;
402
428 template<class... ARGS>
429 void LogCritical(std::string_view fmt, ARGS&&... args) const;
430};
431
433 SDL_LOG_CATEGORY_APPLICATION;
434
435constexpr LogCategory LOG_CATEGORY_ERROR = SDL_LOG_CATEGORY_ERROR;
436
437constexpr LogCategory LOG_CATEGORY_ASSERT = SDL_LOG_CATEGORY_ASSERT;
438
439constexpr LogCategory LOG_CATEGORY_SYSTEM = SDL_LOG_CATEGORY_SYSTEM;
440
441constexpr LogCategory LOG_CATEGORY_AUDIO = SDL_LOG_CATEGORY_AUDIO;
442
443constexpr LogCategory LOG_CATEGORY_VIDEO = SDL_LOG_CATEGORY_VIDEO;
444
445constexpr LogCategory LOG_CATEGORY_RENDER = SDL_LOG_CATEGORY_RENDER;
446
447constexpr LogCategory LOG_CATEGORY_INPUT = SDL_LOG_CATEGORY_INPUT;
448
449constexpr LogCategory LOG_CATEGORY_TEST = SDL_LOG_CATEGORY_TEST;
450
451constexpr LogCategory LOG_CATEGORY_GPU = SDL_LOG_CATEGORY_GPU;
452
454 SDL_LOG_CATEGORY_RESERVED2;
455
457 SDL_LOG_CATEGORY_RESERVED3;
458
460 SDL_LOG_CATEGORY_RESERVED4;
461
463 SDL_LOG_CATEGORY_RESERVED5;
464
466 SDL_LOG_CATEGORY_RESERVED6;
467
469 SDL_LOG_CATEGORY_RESERVED7;
470
472 SDL_LOG_CATEGORY_RESERVED8;
473
475 SDL_LOG_CATEGORY_RESERVED9;
476
478 SDL_LOG_CATEGORY_RESERVED10;
479
480constexpr LogCategory LOG_CATEGORY_CUSTOM = SDL_LOG_CATEGORY_CUSTOM;
481
494inline void SetLogPriorities(LogPriority priority)
495{
496 SDL_SetLogPriorities(priority);
497}
498
513inline void SetLogPriority(int category, LogPriority priority)
514{
515 SDL_SetLogPriority(category, priority);
516}
517
518inline void LogCategory::SetLogPriority(LogPriority priority) const
519{
520 SDL::SetLogPriority(m_category, priority);
521}
522
535inline LogPriority GetLogPriority(int category)
536{
537 return SDL_GetLogPriority(category);
538}
539
541{
542 return SDL::GetLogPriority(m_category);
543}
544
557inline void ResetLogPriorities() { SDL_ResetLogPriorities(); }
558
577inline void SetLogPriorityPrefix(LogPriority priority, StringParam prefix)
578{
579 CheckError(SDL_SetLogPriorityPrefix(priority, prefix));
580}
581
604inline void LogUnformatted(LogCategory category,
605 LogPriority priority,
606 StringParam message)
607{
608 SDL_LogMessage(category, priority, "%s", static_cast<const char*>(message));
609}
610
631inline void LogUnformatted(StringParam message)
632{
633 SDL_Log("%s", static_cast<const char*>(message));
634}
635
663template<class... ARGS>
664inline void Log(std::string_view fmt, ARGS&&... args)
665{
666 LOG_CATEGORY_APPLICATION.LogInfo(fmt, std::forward<ARGS>(args)...);
667}
668
692template<class... ARGS>
693inline void LogMessage(LogCategory category,
694 LogPriority priority,
695 std::string_view fmt,
696 ARGS... args)
697{
699 category, priority, std::vformat(fmt, std::make_format_args(args...)));
700}
701
702template<class... ARGS>
704 std::string_view fmt,
705 ARGS... args) const
706{
707 SDL::LogMessage(m_category, priority, fmt, args...);
708}
709
733template<class... ARGS>
734inline void LogTrace(LogCategory category, std::string_view fmt, ARGS&&... args)
735{
736 LogMessage(category, LOG_PRIORITY_TRACE, fmt, args...);
737}
738
739template<class... ARGS>
740inline void LogCategory::LogTrace(std::string_view fmt, ARGS&&... args) const
741{
742 SDL::LogTrace(m_category, fmt, args...);
743}
744
766template<class... ARGS>
767inline void LogVerbose(LogCategory category,
768 std::string_view fmt,
769 ARGS&&... args)
770{
771 LogMessage(category, LOG_PRIORITY_VERBOSE, fmt, args...);
772}
773
774template<class... ARGS>
775inline void LogCategory::LogVerbose(std::string_view fmt, ARGS&&... args) const
776{
777 SDL::LogVerbose(m_category, fmt, args...);
778}
779
802template<class... ARGS>
803inline void LogDebug(LogCategory category, std::string_view fmt, ARGS&&... args)
804{
805 LogMessage(category, LOG_PRIORITY_DEBUG, fmt, args...);
806}
807
808template<class... ARGS>
809inline void LogCategory::LogDebug(std::string_view fmt, ARGS&&... args) const
810{
811 SDL::LogDebug(m_category, fmt, args...);
812}
813
836template<class... ARGS>
837inline void LogInfo(LogCategory category, std::string_view fmt, ARGS&&... args)
838{
839 LogMessage(category, LOG_PRIORITY_INFO, fmt, args...);
840}
841
842template<class... ARGS>
843inline void LogCategory::LogInfo(std::string_view fmt, ARGS&&... args) const
844{
845 SDL::LogInfo(m_category, fmt, args...);
846}
847
870template<class... ARGS>
871inline void LogWarn(LogCategory category, std::string_view fmt, ARGS&&... args)
872{
873 LogMessage(category, SDL_LOG_PRIORITY_WARN, fmt, args...);
874}
875
876template<class... ARGS>
877inline void LogCategory::LogWarn(std::string_view fmt, ARGS&&... args) const
878{
879 SDL::LogWarn(m_category, fmt, args...);
880}
881
904template<class... ARGS>
905inline void LogError(LogCategory category, std::string_view fmt, ARGS&&... args)
906{
907 LogMessage(category, SDL_LOG_PRIORITY_ERROR, fmt, args...);
908}
909
910template<class... ARGS>
911inline void LogCategory::LogError(std::string_view fmt, ARGS&&... args) const
912{
913 SDL::LogError(m_category, fmt, args...);
914}
915
938template<class... ARGS>
939inline void LogCritical(LogCategory category,
940 std::string_view fmt,
941 ARGS&&... args)
942{
943 LogMessage(category, SDL_LOG_PRIORITY_CRITICAL, fmt, args...);
944}
945
946template<class... ARGS>
947inline void LogCategory::LogCritical(std::string_view fmt, ARGS&&... args) const
948{
949 SDL::LogCritical(m_category, fmt, args...);
950}
951
966using LogOutputFunction = SDL_LogOutputFunction;
967
985using LogOutputCB = std::function<void(LogCategory, LogPriority, const char*)>;
986
1000{
1001 return SDL_GetDefaultLogOutputFunction();
1002}
1003
1018inline void GetLogOutputFunction(LogOutputFunction* callback, void** userdata)
1019{
1020 SDL_GetLogOutputFunction(callback, userdata);
1021}
1022
1039{
1040 using Wrapper = UniqueCallbackWrapper<LogOutputCB>;
1042 void* userdata;
1043 GetLogOutputFunction(&cb, &userdata);
1044 if (userdata == nullptr) {
1045 return [cb](LogCategory c, LogPriority p, StringParam m) {
1046 cb(nullptr, c, p, m);
1047 };
1048 }
1049 if (auto cb = Wrapper::at(userdata)) return cb;
1050 return [cb, userdata](LogCategory c, LogPriority p, StringParam m) {
1051 cb(userdata, c, p, m);
1052 };
1053}
1054
1069inline void SetLogOutputFunction(LogOutputFunction callback, void* userdata)
1070{
1072 return SDL_SetLogOutputFunction(callback, userdata);
1073}
1074
1092{
1093 using Wrapper = UniqueCallbackWrapper<LogOutputCB>;
1094 SDL_SetLogOutputFunction(
1095 [](
1096 void* userdata, int category, LogPriority priority, const char* message) {
1097 return Wrapper::Call(userdata, LogCategory{category}, priority, message);
1098 },
1099 Wrapper::Wrap(std::move(callback)));
1100}
1101
1113{
1115}
1116
1118
1119} // namespace SDL
1120
1121#endif /* SDL3PP_LOG_H_ */
The predefined log categories.
Definition: SDL3pp_log.h:128
Helpers to use C++ strings parameters.
Definition: SDL3pp_strings.h:43
constexpr void CheckError(bool result)
Check and throw if returned value from SDL is an error.
Definition: SDL3pp_error.h:197
void SetLogPriorities(LogPriority priority)
Set the priority of all log categories.
Definition: SDL3pp_log.h:494
constexpr LogCategory LOG_CATEGORY_ASSERT
ASSERT.
Definition: SDL3pp_log.h:437
constexpr LogCategory LOG_CATEGORY_AUDIO
AUDIO.
Definition: SDL3pp_log.h:441
void LogWarn(std::string_view fmt, ARGS &&... args) const
Log a message with LOG_PRIORITY_WARN.
Definition: SDL3pp_log.h:877
constexpr LogCategory LOG_CATEGORY_VIDEO
VIDEO.
Definition: SDL3pp_log.h:443
SDL_LogCategory LogCategoryRaw
Alias to raw representation for LogCategory.
Definition: SDL3pp_log.h:63
constexpr LogCategory LOG_CATEGORY_RESERVED10
RESERVED10.
Definition: SDL3pp_log.h:477
void LogVerbose(LogCategory category, std::string_view fmt, ARGS &&... args)
Log a message with LOG_PRIORITY_VERBOSE.
Definition: SDL3pp_log.h:767
void SetLogPriorityPrefix(LogPriority priority, StringParam prefix)
Set the text prepended to log messages of a given priority.
Definition: SDL3pp_log.h:577
LogPriority GetLogPriority(int category)
Get the priority of a particular log category.
Definition: SDL3pp_log.h:535
void SetLogPriority(int category, LogPriority priority)
Set the priority of a particular log category.
Definition: SDL3pp_log.h:513
void LogTrace(LogCategory category, std::string_view fmt, ARGS &&... args)
Log a message with LOG_PRIORITY_TRACE.
Definition: SDL3pp_log.h:734
void LogUnformatted(LogPriority priority, StringParam message) const
Log an unformatted message with the specified priority.
Definition: SDL3pp_log.h:207
constexpr LogPriority LOG_PRIORITY_INVALID
INVALID.
Definition: SDL3pp_log.h:83
void SetLogOutputFunction(LogOutputFunction callback, void *userdata)
Replace the default log output function with one of your own.
Definition: SDL3pp_log.h:1069
constexpr LogCategory LOG_CATEGORY_INPUT
INPUT.
Definition: SDL3pp_log.h:447
LogOutputCB GetLogOutputFunction()
Get the current log output function.
Definition: SDL3pp_log.h:1038
constexpr LogCategory LOG_CATEGORY_ERROR
ERROR.
Definition: SDL3pp_log.h:435
void LogInfo(std::string_view fmt, ARGS &&... args) const
Log a message with LOG_PRIORITY_INFO.
Definition: SDL3pp_log.h:843
constexpr LogCategory(int category)
Wraps LogCategory.
Definition: SDL3pp_log.h:147
constexpr LogCategory LOG_CATEGORY_RESERVED5
RESERVED5.
Definition: SDL3pp_log.h:462
void LogVerbose(std::string_view fmt, ARGS &&... args) const
Log a message with LOG_PRIORITY_VERBOSE.
Definition: SDL3pp_log.h:775
void LogCritical(LogCategory category, std::string_view fmt, ARGS &&... args)
Log a message with LOG_PRIORITY_CRITICAL.
Definition: SDL3pp_log.h:939
void LogTrace(std::string_view fmt, ARGS &&... args) const
Log a message with LOG_PRIORITY_TRACE.
Definition: SDL3pp_log.h:740
void ResetLogOutputFunction()
Replace the current log output function with the default one.
Definition: SDL3pp_log.h:1112
constexpr LogPriority LOG_PRIORITY_CRITICAL
CRITICAL.
Definition: SDL3pp_log.h:99
void LogCritical(std::string_view fmt, ARGS &&... args) const
Log a message with LOG_PRIORITY_CRITICAL.
Definition: SDL3pp_log.h:947
void LogDebug(LogCategory category, std::string_view fmt, ARGS &&... args)
Log a message with LOG_PRIORITY_DEBUG.
Definition: SDL3pp_log.h:803
constexpr LogCategory LOG_CATEGORY_RESERVED8
RESERVED8.
Definition: SDL3pp_log.h:471
LogPriority GetLogPriority() const
Get the priority of a particular log category.
Definition: SDL3pp_log.h:540
SDL_LogPriority LogPriority
The predefined log priorities.
Definition: SDL3pp_log.h:81
void LogError(std::string_view fmt, ARGS &&... args) const
Log a message with LOG_PRIORITY_ERROR.
Definition: SDL3pp_log.h:911
constexpr LogCategory LOG_CATEGORY_RESERVED7
RESERVED7.
Definition: SDL3pp_log.h:468
constexpr LogPriority LOG_PRIORITY_WARN
WARN.
Definition: SDL3pp_log.h:95
void LogUnformatted(LogCategory category, LogPriority priority, StringParam message)
Log an unformatted message with LOG_CATEGORY_APPLICATION and LOG_PRIORITY_INFO.
Definition: SDL3pp_log.h:604
void LogMessage(LogPriority priority, std::string_view fmt, ARGS... args) const
Log a message with the specified priority.
Definition: SDL3pp_log.h:703
void LogDebug(std::string_view fmt, ARGS &&... args) const
Log a message with LOG_PRIORITY_DEBUG.
Definition: SDL3pp_log.h:809
void LogError(LogCategory category, std::string_view fmt, ARGS &&... args)
Log a message with LOG_PRIORITY_ERROR.
Definition: SDL3pp_log.h:905
constexpr LogCategory LOG_CATEGORY_TEST
TEST.
Definition: SDL3pp_log.h:449
constexpr LogCategory LOG_CATEGORY_RESERVED2
RESERVED2.
Definition: SDL3pp_log.h:453
constexpr LogPriority LOG_PRIORITY_DEBUG
DEBUG.
Definition: SDL3pp_log.h:91
void LogMessage(LogCategory category, LogPriority priority, std::string_view fmt, ARGS... args)
Log a message with the specified category and priority.
Definition: SDL3pp_log.h:693
void Log(std::string_view fmt, ARGS &&... args)
Log a message with LOG_CATEGORY_APPLICATION and LOG_PRIORITY_INFO.
Definition: SDL3pp_log.h:664
constexpr LogCategory LOG_CATEGORY_RENDER
RENDER.
Definition: SDL3pp_log.h:445
constexpr LogCategory LOG_CATEGORY_APPLICATION
APPLICATION.
Definition: SDL3pp_log.h:432
constexpr LogCategory LOG_CATEGORY_GPU
GPU.
Definition: SDL3pp_log.h:451
std::function< void(LogCategory, LogPriority, const char *)> LogOutputCB
The prototype for the log output callback function.
Definition: SDL3pp_log.h:985
void LogInfo(LogCategory category, std::string_view fmt, ARGS &&... args)
Log a message with LOG_PRIORITY_INFO.
Definition: SDL3pp_log.h:837
constexpr LogCategory LOG_CATEGORY_SYSTEM
SYSTEM.
Definition: SDL3pp_log.h:439
void SetLogPriority(LogPriority priority) const
Set the priority of a particular log category.
Definition: SDL3pp_log.h:518
SDL_LogOutputFunction LogOutputFunction
The prototype for the log output callback function.
Definition: SDL3pp_log.h:966
void ResetLogPriorities()
Reset all priorities to default.
Definition: SDL3pp_log.h:557
constexpr LogPriority LOG_PRIORITY_ERROR
ERROR.
Definition: SDL3pp_log.h:97
constexpr LogPriority LOG_PRIORITY_COUNT
COUNT.
Definition: SDL3pp_log.h:102
void LogWarn(LogCategory category, std::string_view fmt, ARGS &&... args)
Log a message with LOG_PRIORITY_WARN.
Definition: SDL3pp_log.h:871
LogOutputFunction GetDefaultLogOutputFunction()
Get the default log output function.
Definition: SDL3pp_log.h:999
constexpr LogPriority LOG_PRIORITY_VERBOSE
VERBOSE.
Definition: SDL3pp_log.h:88
constexpr LogPriority LOG_PRIORITY_INFO
INFO.
Definition: SDL3pp_log.h:93
constexpr LogCategory LOG_CATEGORY_RESERVED9
RESERVED9.
Definition: SDL3pp_log.h:474
constexpr LogCategory LOG_CATEGORY_RESERVED4
RESERVED4.
Definition: SDL3pp_log.h:459
constexpr LogPriority LOG_PRIORITY_TRACE
TRACE.
Definition: SDL3pp_log.h:86
constexpr LogCategory LOG_CATEGORY_CUSTOM
CUSTOM.
Definition: SDL3pp_log.h:480
constexpr LogCategory(LogCategoryRaw category=SDL_LOG_CATEGORY_APPLICATION)
Wraps LogCategory.
Definition: SDL3pp_log.h:137
constexpr LogCategory LOG_CATEGORY_RESERVED3
RESERVED3.
Definition: SDL3pp_log.h:456
constexpr LogCategory LOG_CATEGORY_RESERVED6
RESERVED6.
Definition: SDL3pp_log.h:465
Main include header for the SDL3pp library.
Stored Wrapper unique by type result callbacks.
Definition: SDL3pp_callbackWrapper.h:242