이 페이지에서

QMessageLogger Class

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

헤더: #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)

function 의 line 에 있는 file 에 대한 로그 메시지를 기록하기 위해 QMessageLogger를 생성합니다. 이는 QMessageLogger(file, line, function, "default")와 동일합니다.

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

function 의 line 에서 file 에 대한 category 메시지를 기록하도록 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

cat 컨텍스트에 대해 msg 형식으로 지정된 중요 메시지를 기록합니다. 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

cat 컨텍스트에 대해 msg 형식으로 지정된 치명적 메시지를 기록합니다. 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

cat 컨텍스트에 대해 msg 형식으로 지정된 정보 메시지를 기록합니다. 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

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

qCWarning()도 참조하십시오 .

© 2026 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.