QMessageLogger Class

QMessageLogger 클래스는 로그 메시지를 생성합니다. 더 보기...

Header: #include <QMessageLogger>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

공용 타입

공용 함수

QMessageLogger()
QMessageLogger(const char *file, int line, const char *function)
QMessageLogger(const char *file, int line, const char *function, const char *category)
QDebug critical() const
QDebug critical(QMessageLogger::CategoryFunction catFunc) const
QDebug critical(const QLoggingCategory &cat) const
void critical(const char *msg, ...) const
void critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void critical(const QLoggingCategory &cat, const char *msg, ...) const
QDebug debug() const
QDebug debug(QMessageLogger::CategoryFunction catFunc) const
QDebug debug(const QLoggingCategory &cat) const
void debug(const char *msg, ...) const
void debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void debug(const QLoggingCategory &cat, const char *msg, ...) const
(since 6.5) QDebug fatal() const
(since 6.5) QDebug fatal(QMessageLogger::CategoryFunction catFunc) const
(since 6.5) QDebug fatal(const QLoggingCategory &cat) const
void fatal(const char *msg, ...) const
(since 6.5) void fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
(since 6.5) void fatal(const QLoggingCategory &cat, const char *msg, ...) const
QDebug info() const
QDebug info(QMessageLogger::CategoryFunction catFunc) const
QDebug info(const QLoggingCategory &cat) const
void info(const char *msg, ...) const
void info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void info(const QLoggingCategory &cat, const char *msg, ...) const
QDebug warning() const
QDebug warning(QMessageLogger::CategoryFunction catFunc) const
QDebug warning(const QLoggingCategory &cat) const
void warning(const char *msg, ...) const
void warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void warning(const QLoggingCategory &cat, const char *msg, ...) const

상세 설명

QMessageLogger는 Qt 로깅 프레임워크용 메시지를 생성하는 데 사용됩니다. 일반적으로 qDebug(), qInfo(), qWarning(), qCritical, 또는 qFatal() 함수를 통해 사용하며, 실제로는 매크로입니다: 예를 들어 qDebug()는 QMessageLogger(__FILE__, __LINE__, Q_FUNC_INFO), 디버그 빌드의 경우debug(), 릴리스 빌드의 경우 QMessageLogger(0, 0, 0),debug()로 확장됩니다.

직접 사용하는 한 가지 예는 스크립팅 언어(예: QML)에서 발생한 오류를 전달하는 것입니다:

    void statusChanged(QQmlComponent::Status status) {
        if (status == QQmlComponent::Error) {
            for (const QQmlError &error: std::as_const(component->errors())) {
                const QByteArray file = error.url().toEncoded();
                QMessageLogger(file.constData(), error.line(), 0).debug() << error.description();
            }
        }
    }

QMessageLogContext, qDebug(), qInfo(), qWarning(), qCritical() 및 qFatal()도 참조하세요 .

멤버 유형 문서

QMessageLogger::CategoryFunction

이것은 다음 서명을 가진 함수에 대한 포인터에 대한 typedef입니다:

    const QLoggingCategory &category();

Q_DECLARE_LOGGING_CATEGORY 매크로는 이 서명을 가진 함수 선언을 생성하고 Q_LOGGING_CATEGORY 은 그 정의를 생성합니다.

QLoggingCategory도 참조하세요 .

멤버 함수 문서

[constexpr] QMessageLogger::QMessageLogger()

기본 QMessageLogger를 구축합니다. 컨텍스트 정보를 지정하려면 다른 생성자를 참조하세요.

[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function)

line 에서 file 에 대한 로그 메시지를 function 에 기록하는 QMessageLogger를 구축합니다. 이는 QMessageLogger(file, line, function, "default")와 동일합니다.

[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)

fileline 에 대한 category 메시지를 function 에 기록하는 QMessageLogger를 구축합니다.

QLoggingCategory도 참조하십시오 .

QDebug QMessageLogger::critical() const

QDebug 스트림을 사용하여 중요한 메시지를 기록합니다.

qCritical() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc) const

QDebug 스트림을 사용하여 catFunc 에서 반환한 카테고리에 중요 메시지를 기록합니다.

qCCritical() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::critical(const QLoggingCategory &cat) const

QDebug 스트림을 사용하여 중요 메시지를 cat 카테고리에 기록합니다.

qCCritical() 및 QDebug도 참조하세요 .

void QMessageLogger::critical(const char *msg, ...) const

msg 형식으로 지정된 중요 메시지를 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCritical()도 참조하세요 .

void QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc 에서 반환한 컨텍스트에 대해 msg 형식으로 지정된 중요 메시지를 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCCritical()도 참조하세요 .

void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const

컨텍스트에 대해 msg 형식으로 지정된 중요 메시지를 cat 로 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCCritical()도 참조하세요 .

QDebug QMessageLogger::debug() const

QDebug 스트림을 사용하여 디버그 메시지를 기록합니다.

qDebug() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc) const

QDebug 스트림을 사용하여 catFunc 에서 반환한 카테고리에 디버그 메시지를 기록합니다.

qCDebug() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::debug(const QLoggingCategory &cat) const

QDebug 스트림을 사용하여 cat 카테고리에 디버그 메시지를 기록합니다.

qCDebug() 및 QDebug도 참조하세요 .

void QMessageLogger::debug(const char *msg, ...) const

msg 형식으로 지정된 디버그 메시지를 기록합니다. msg 으로 지정된 추가 매개 변수를 사용할 수 있습니다.

qDebug()도 참조하세요 .

void QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc 에서 반환한 컨텍스트에 대해 msg 형식으로 지정된 디버그 메시지를 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCDebug()도 참조하세요 .

void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const

cat 컨텍스트에 대해 msg 형식으로 지정된 디버그 메시지를 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCDebug()도 참조하세요 .

[since 6.5] QDebug QMessageLogger::fatal() const

QDebug 스트림을 사용하여 치명적인 메시지를 기록합니다.

이 함수는 Qt 6.5에 도입되었습니다.

qFatal() 및 QDebug참조하십시오 .

[since 6.5] QDebug QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc) const

QDebug 스트림을 사용하여 catFunc 에서 반환한 범주에 치명적인 메시지를 기록합니다.

이 함수는 Qt 6.5에 도입되었습니다.

qCFatal() 및 QDebug도 참조하십시오 .

[since 6.5] QDebug QMessageLogger::fatal(const QLoggingCategory &cat) const

QDebug 스트림을 사용하여 치명적인 메시지를 cat 카테고리에 기록합니다.

이 함수는 Qt 6.5에 도입되었습니다.

qCFatal() 및 QDebug참조하십시오 .

[noexcept] void QMessageLogger::fatal(const char *msg, ...) const

msg 형식으로 지정된 치명적인 메시지를 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qFatal()도 참조하세요 .

[noexcept, since 6.5] void QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc 에서 반환한 컨텍스트에 대해 msg 형식으로 지정된 치명적인 메시지를 기록합니다. msg 로 지정된 추가 파라미터를 사용할 수 있습니다.

이 함수는 Qt 6.5에 도입되었습니다.

qCFatal()도 참조하십시오 .

[noexcept, since 6.5] void QMessageLogger::fatal(const QLoggingCategory &cat, const char *msg, ...) const

컨텍스트에 대해 msg 형식으로 지정된 치명적인 메시지를 cat 로 기록합니다. msg 로 지정된 추가 파라미터를 사용할 수 있습니다.

이 함수는 Qt 6.5에 도입되었습니다.

qCFatal()도 참조하십시오 .

QDebug QMessageLogger::info() const

QDebug 스트림을 사용하여 정보 메시지를 기록합니다.

qInfo() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::info(QMessageLogger::CategoryFunction catFunc) const

QDebug 스트림을 사용하여 catFunc 에서 반환한 카테고리에 정보 메시지를 기록합니다.

qCInfo() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::info(const QLoggingCategory &cat) const

QDebug 스트림을 사용하여 cat 카테고리에 정보 메시지를 기록합니다.

qCInfo() 및 QDebug도 참조하세요 .

void QMessageLogger::info(const char *msg, ...) const

msg 형식으로 지정된 정보 메시지를 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qInfo()도 참조하세요 .

void QMessageLogger::info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc 에서 반환한 컨텍스트에 대해 msg 형식으로 지정된 정보 메시지를 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCInfo()도 참조하세요 .

void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const

컨텍스트에 대해 msg 형식으로 지정된 정보 메시지를 cat 로 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCInfo()도 참조하세요 .

QDebug QMessageLogger::warning() const

QDebug 스트림을 사용하여 경고 메시지를 기록합니다.

qWarning() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc) const

QDebug 스트림을 사용하여 catFunc 에서 반환한 카테고리에 경고 메시지를 기록합니다.

qCWarning() 및 QDebug도 참조하세요 .

QDebug QMessageLogger::warning(const QLoggingCategory &cat) const

QDebug 스트림을 사용하여 cat 카테고리에 경고 메시지를 기록합니다.

qCWarning() 및 QDebug도 참조하세요 .

void QMessageLogger::warning(const char *msg, ...) const

msg 형식으로 지정된 경고 메시지를 기록합니다. msg 으로 지정된 추가 매개 변수를 사용할 수 있습니다.

qWarning()도 참조하세요 .

void QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc 에서 반환한 컨텍스트에 대해 msg 형식으로 지정된 경고 메시지를 기록합니다. msg 으로 지정된 추가 매개 변수를 사용할 수 있습니다.

qCWarning()도 참조하세요 .

void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const

컨텍스트에 대해 msg 형식으로 지정된 경고 메시지를 cat 로 기록합니다. msg 으로 지정된 추가 매개변수를 사용할 수 있습니다.

qCWarning()도 참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.