QLoggingCategory Class

매크로 문서

[since 6.5] Q_DECLARE_EXPORTED_LOGGING_CATEGORY(name, EXPORT_MACRO)

name 라는 로깅 범주를 선언합니다. 이 매크로는 프로그램의 여러 부분에서 공유되는 공통 로깅 범주를 선언하는 데 사용할 수 있습니다.

이 매크로는 Q_DECLARE_LOGGING_CATEGORY()과 정확히 동일하게 작동합니다. 다만, 이 매크로로 선언된 로깅 카테고리에는 EXPORT_MACRO 라는 수식어가 추가로 붙습니다. 이는 로깅 카테고리를 동적 라이브러리에서 내보내야 할 때 유용합니다.

예를 들어:

Q_DECLARE_EXPORTED_LOGGING_CATEGORY(lcCore, LIB_EXPORT_MACRO)

이 매크로는 클래스나 함수 외부에서 사용해야 합니다.

이 매크로는 Qt 6.5에서 도입되었습니다.

Q_LOGGING_CATEGORY() 및 Q_DECLARE_LOGGING_CATEGORY()도 참조하십시오 .

Q_DECLARE_LOGGING_CATEGORY(name)

name 라는 로깅 범주를 선언합니다. 이 매크로는 프로그램의 여러 부분에서 공유되는 공통 로깅 범주를 선언하는 데 사용할 수 있습니다.

이 매크로는 클래스나 메서드 외부에서 사용해야 합니다.

Q_LOGGING_CATEGORY() 및 Q_DECLARE_EXPORTED_LOGGING_CATEGORY()도 참조하십시오 .

Q_LOGGING_CATEGORY(name, string)

name 로깅 범주를 정의하고, 이를 string 식별자 하에서 구성 가능하게 만듭니다. 기본적으로 모든 메시지 유형이 활성화되어 있습니다.

라이브러리나 실행 파일 내에서는 하나의 번역 단위만 특정 이름을 가진 범주를 정의할 수 있습니다. 암시적으로 정의된 QLoggingCategory 객체는 처음 사용 시 스레드 안전 방식으로 생성됩니다.

이 매크로는 클래스나 메서드 외부에서 사용해야 합니다.

Q_DECLARE_LOGGING_CATEGORY() 및 Q_DECLARE_EXPORTED_LOGGING_CATEGORY()도 참조하십시오 .

Q_LOGGING_CATEGORY(name, string, msgType)

name 로깅 범주를 정의하고, string 식별자 하에서 구성할 수 있도록 합니다. 기본적으로 QtMsgType, msgType 및 그보다 심각도가 높은 메시지는 활성화되며, 심각도가 더 낮은 유형의 메시지는 비활성화됩니다.

라이브러리나 실행 파일 내에서는 특정 이름을 가진 범주를 정의할 수 있는 번역 단위가 하나뿐입니다. 암시적으로 정의된 QLoggingCategory 객체는 처음 사용 시 스레드 안전 방식으로 생성됩니다.

이 매크로는 클래스나 메서드 외부에서 사용해야 합니다.

Q_DECLARE_LOGGING_CATEGORY()도 참조하십시오 .

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string)

정적 로깅 범주 name 를 정의하고, string 식별자 아래에서 이를 구성할 수 있도록 합니다. 기본적으로 모든 메시지 유형이 활성화되어 있습니다.

이 로깅 범주는 static 한정자를 사용하여 생성되므로, 동일한 번역 단위 내에서만 액세스할 수 있습니다. 이를 통해 의도하지 않은 심볼 충돌을 방지할 수 있습니다.

암시적으로 정의된 QLoggingCategory 객체는 첫 사용 시 스레드 안전하게 생성됩니다.

이 매크로는 클래스나 메서드 외부에서 사용해야 합니다.

이 매크로는 Qt 6.9에서 도입되었습니다.

Q_LOGGING_CATEGORY()도 참조하십시오 .

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string, msgType)

정적 로깅 범주 name 를 정의하고, 이를 string 식별자 하에서 구성할 수 있도록 합니다. 기본적으로 QtMsgType, msgType 및 이보다 심각도가 높은 메시지는 활성화되며, 심각도가 더 낮은 유형은 비활성화됩니다.

이 로깅 범주는 static 한정자를 사용하여 생성되므로, 동일한 번역 단위 내에서만 액세스할 수 있습니다. 이를 통해 의도치 않은 심볼 충돌을 방지할 수 있습니다.

암시적으로 정의된 QLoggingCategory 객체는 첫 사용 시 스레드 안전 방식으로 생성됩니다.

이 매크로는 클래스나 메서드 외부에서 사용해야 합니다.

이 매크로는 Qt 6.9에서 도입되었습니다.

Q_LOGGING_CATEGORY()도 참조하십시오 .

qCCritical(category)

category 로깅 범주에 속하는 중요 메시지에 대한 출력 스트림을 반환합니다.

이 매크로는 ` QLoggingCategory::isCriticalEnabled()`의 평가 결과가 ` true`인지 확인하는 코드로 확장됩니다. 해당 조건이 충족되면 스트림 인수가 처리되어 메시지 핸들러로 전송됩니다.

예시:

    QLoggingCategory category("driver.usb");
    qCCritical(category) << "a critical message";

QDebug::qCritical()도 참조하십시오 .

qCCritical(category, const char *message, ...)

로깅 범주인 category 에 중요 메시지인 message 를 기록합니다. message 에는 C 언어의 printf() 함수와 마찬가지로 추가 인자로 대체될 자리 표시자가 포함될 수 있습니다.

예시:

    QLoggingCategory category("driver.usb");
    qCCritical(category, "a critical message logged into category %s", category.categoryName());

qCritical(const char *, ...)도 참조하십시오 .

qCDebug(category)

category 로깅 범주의 디버그 메시지용 출력 스트림을 반환합니다.

이 매크로는 QLoggingCategory::isDebugEnabled()의 평가 결과가 true 인지 확인하는 코드로 확장됩니다. 그렇다면 스트림 인자가 처리되어 메시지 핸들러로 전송됩니다.

예시:

    QLoggingCategory category("driver.usb");
    qCDebug(category) << "a debug message";

QDebug::qDebug()도 참조하십시오 .

qCDebug(category, const char *message, ...)

로깅 범주( category)에 디버그 메시지( message)를 기록합니다. message 에는 C 언어의 printf() 함수와 마찬가지로, 추가 인자로 대체될 자리 표시자가 포함될 수 있습니다.

예시:

    QLoggingCategory category("driver.usb");
    qCDebug(category, "a debug message logged into category %s", category.categoryName());

qDebug(const char *, ...)도 참조하십시오 .

[since 6.5] qCFatal(category)

category 로깅 범주에 속하는 치명적 메시지에 대한 출력 스트림을 반환합니다.

기본 메시지 핸들러를 사용하는 경우, 반환된 스트림은 코어 덤프를 생성하기 위해 중단됩니다. Windows에서 디버그 빌드의 경우, 이 함수는 _CRT_ERROR 를 보고하여 디버거를 애플리케이션에 연결할 수 있게 합니다.

예시:

    QLoggingCategory category("driver.usb");
    qCFatal(category) << "a fatal message. Program will be terminated!";

이 매크로는 Qt 6.5에서 도입되었습니다.

QDebug::qFatal()도 참조하십시오 .

[since 6.5] qCFatal(category, const char *message, ...)

로깅 범주 category 에서 치명적 메시지 message 를 기록합니다. message 에는 C 언어의 printf() 함수와 마찬가지로 추가 인자로 대체될 자리 표시자가 포함될 수 있습니다.

예시:

    QLoggingCategory category("driver.usb");
    qCFatal(category, "a fatal message. Program will be terminated!");

기본 메시지 핸들러를 사용하는 경우, 이 함수는 코어 덤프를 생성하기 위해 실행을 중단합니다. Windows에서 디버그 빌드의 경우, 이 함수는 _CRT_ERROR 를 보고하여 디버거를 애플리케이션에 연결할 수 있게 해줍니다.

이 매크로는 Qt 6.5에서 도입되었습니다.

qFatal(const char *, ...)도 참조하십시오 .

qCInfo(category)

category 로깅 범주에 속하는 정보 메시지에 대한 출력 스트림을 반환합니다.

이 매크로는 ` QLoggingCategory::isInfoEnabled()`의 평가 결과가 ` true`인지 확인하는 코드로 확장됩니다. 해당 조건이 충족되면 스트림 인수가 처리되어 메시지 핸들러로 전송됩니다.

예시:

    QLoggingCategory category("driver.usb");
    qCInfo(category) << "an informational message";

QDebug::qInfo()도 참조하십시오 .

qCInfo(category, const char *message, ...)

로깅 범주( category)에 정보 메시지 message 를 기록합니다. message 에는 C 언어의 printf() 함수와 마찬가지로 추가 인자로 대체될 자리 표시자가 포함될 수 있습니다.

예시:

    QLoggingCategory category("driver.usb");
    qCInfo(category, "an informational message logged into category %s", category.categoryName());

qInfo(const char *, ...)도 참조하십시오 .

qCWarning(category)

category 로깅 범주의 경고 메시지를 위한 출력 스트림을 반환합니다.

이 매크로는 QLoggingCategory::isWarningEnabled()의 평가 결과가 true 인지 확인하는 코드로 확장됩니다. 그렇다면 스트림 인수가 처리되어 메시지 핸들러로 전송됩니다.

예시:

    QLoggingCategory category("driver.usb");
    qCWarning(category) << "a warning message";

QDebug::qWarning()도 참조하십시오 .

qCWarning(category, const char *message, ...)

로깅 범주( category)에 경고 메시지 message 를 기록합니다. message 에는 C 언어의 printf() 함수와 유사하게, 추가 인자로 대체될 자리 표시자가 포함될 수 있습니다.

예시:

    QLoggingCategory category("driver.usb");
    qCWarning(category, "a warning message logged into category %s", category.categoryName());

qWarning(const char *, ...)도 참조하십시오 .