/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QLOGGINGCATEGORY_H #define QLOGGINGCATEGORY_H #include #include QT_BEGIN_NAMESPACE class Q_CORE_EXPORT QLoggingCategory { Q_DISABLE_COPY(QLoggingCategory) public: explicit QLoggingCategory(const char *category, QtMsgType severityLevel = QtDebugMsg); ~QLoggingCategory(); bool isEnabled(QtMsgType type) const; void setEnabled(QtMsgType type, bool enable); #ifdef Q_ATOMIC_INT8_IS_SUPPORTED bool isDebugEnabled() const { return bools.enabledDebug.loadRelaxed(); } bool isInfoEnabled() const { return bools.enabledInfo.loadRelaxed(); } bool isWarningEnabled() const { return bools.enabledWarning.loadRelaxed(); } bool isCriticalEnabled() const { return bools.enabledCritical.loadRelaxed(); } #else bool isDebugEnabled() const { return enabled.loadRelaxed() >> DebugShift & 1; } bool isInfoEnabled() const { return enabled.loadRelaxed() >> InfoShift & 1; } bool isWarningEnabled() const { return enabled.loadRelaxed() >> WarningShift & 1; } bool isCriticalEnabled() const { return enabled.loadRelaxed() >> CriticalShift & 1; } #endif const char *categoryName() const { return name; } // allows usage of both factory method and variable in qCX macros QLoggingCategory &operator()() { return *this; } const QLoggingCategory &operator()() const { return *this; } static QLoggingCategory *defaultCategory(); typedef void (*CategoryFilter)(QLoggingCategory*); static CategoryFilter installFilter(CategoryFilter); static void setFilterRules(const QString &rules); private: void init(const char *category, QtMsgType severityLevel); Q_DECL_UNUSED_MEMBER void *d; // reserved for future use const char *name; #ifdef Q_BIG_ENDIAN enum { DebugShift = 0, WarningShift = 8, CriticalShift = 16, InfoShift = 24 }; #else enum { DebugShift = 24, WarningShift = 16, CriticalShift = 8, InfoShift = 0}; #endif struct AtomicBools { #ifdef Q_ATOMIC_INT8_IS_SUPPORTED QBasicAtomicInteger enabledDebug; QBasicAtomicInteger enabledWarning; QBasicAtomicInteger enabledCritical; QBasicAtomicInteger enabledInfo; #endif }; union { AtomicBools bools; QBasicAtomicInt enabled; }; Q_DECL_UNUSED_MEMBER bool placeholder[4]; // reserved for future use }; namespace { // allow different TUs to have different QT_NO_xxx_OUTPUT template struct QLoggingCategoryMacroHolder { static const bool IsOutputEnabled; const QLoggingCategory *category = nullptr; bool control = false; QLoggingCategoryMacroHolder(const QLoggingCategory &cat) { if (IsOutputEnabled) init(cat); } QLoggingCategoryMacroHolder(QMessageLogger::CategoryFunction catfunc) { if (IsOutputEnabled) init(catfunc()); } void init(const QLoggingCategory &cat) noexcept { category = &cat; // same as: // control = cat.isEnabled(Which); // but without an out-of-line call if constexpr (Which == QtDebugMsg) { control = cat.isDebugEnabled(); } else if constexpr (Which == QtInfoMsg) { control = cat.isInfoEnabled(); } else if constexpr (Which == QtWarningMsg) { control = cat.isWarningEnabled(); } else { control = cat.isCriticalEnabled(); } } operator const char *() const { return category->categoryName(); } operator bool() const { return Q_UNLIKELY(control); } }; template const bool QLoggingCategoryMacroHolder::IsOutputEnabled = true; #if defined(QT_NO_DEBUG_OUTPUT) template <> const bool QLoggingCategoryMacroHolder::IsOutputEnabled = false; #endif #if defined(QT_NO_INFO_OUTPUT) template <> const bool QLoggingCategoryMacroHolder::IsOutputEnabled = false; #endif #if defined(QT_NO_WARNING_OUTPUT) template <> const bool QLoggingCategoryMacroHolder::IsOutputEnabled = false; #endif } // unnamed namespace #define Q_DECLARE_LOGGING_CATEGORY(name) \ extern const QLoggingCategory &name(); #define Q_LOGGING_CATEGORY(name, ...) \ const QLoggingCategory &name() \ { \ static const QLoggingCategory category(__VA_ARGS__); \ return category; \ } #define QT_MESSAGE_LOGGER_COMMON(category, level) \ for (QLoggingCategoryMacroHolder qt_category(category); qt_category; qt_category.control = false) \ QMessageLogger(QT_MESSAGELOG_FILE, QT_MESSAGELOG_LINE, QT_MESSAGELOG_FUNC, qt_category) #define qCDebug(category, ...) QT_MESSAGE_LOGGER_COMMON(category, QtDebugMsg).debug(__VA_ARGS__) #define qCInfo(category, ...) QT_MESSAGE_LOGGER_COMMON(category, QtInfoMsg).info(__VA_ARGS__) #define qCWarning(category, ...) QT_MESSAGE_LOGGER_COMMON(category, QtWarningMsg).warning(__VA_ARGS__) #define qCCritical(category, ...) QT_MESSAGE_LOGGER_COMMON(category, QtCriticalMsg).critical(__VA_ARGS__) QT_END_NAMESPACE #endif // QLOGGINGCATEGORY_H