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 QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc) const
QDebug 스트림을 사용하여 catFunc 에서 반환된 범주에 디버그 메시지를 기록합니다.
QDebug QMessageLogger::debug(const QLoggingCategory &cat) const
QDebug 스트림을 사용하여 ‘ cat ’ 범주에 디버그 메시지를 기록합니다.
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에서 도입되었습니다.
[since 6.5] QDebug QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc) const
QDebug 스트림을 사용하여 catFunc 에서 반환된 범주에 치명적인 메시지를 기록합니다.
이 함수는 Qt 6.5에서 도입되었습니다.
[since 6.5] QDebug QMessageLogger::fatal(const QLoggingCategory &cat) const
QDebug 스트림을 사용하여 ‘ cat ’ 범주에 치명적인 메시지를 기록합니다.
이 함수는 Qt 6.5에서 도입되었습니다.
[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 스트림을 사용하여 정보 메시지를 기록합니다.
QDebug QMessageLogger::info(QMessageLogger::CategoryFunction catFunc) const
QDebug 스트림을 사용하여 catFunc 에서 반환된 범주에 정보 메시지를 기록합니다.
QDebug QMessageLogger::info(const QLoggingCategory &cat) const
QDebug 스트림을 사용하여 ‘ cat ’ 범주에 정보 메시지를 기록합니다.
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 스트림을 사용하여 경고 메시지를 기록합니다.
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.