<QtLogging> - Qt Logging Types

매크로 문서

qCritical(const char *format, ...)

중요 메시지 format 를 중앙 메시지 핸들러에 기록합니다. ` format `에는 추가 인자로 지정된 값으로 대체되는 형식 지정자가 포함될 수 있습니다.

예시:

void load(const QString &fileName)
{
    QFile file(fileName);
    if (!file.exists())
        qCritical("File '%s' does not exist!", qUtf8Printable(fileName));
}

format UTF-8 문자열의 경우 ` %s `와 같은 형식 지정자를, 정수의 경우 ` %i `와 같은 형식 지정자를 포함할 수 있습니다. 이는 C 언어의 ` printf() ` 함수가 작동하는 방식과 유사합니다. 서식에 대한 자세한 내용은 ` QString::asprintf()`를 참조하십시오.

더 큰 편의성과 더 다양한 유형 지원을 위해, 스트리밍 패러다임을 따르는 QDebug::qCritical()을 사용할 수도 있습니다( std::cout 또는 std::cerr 와 유사).

실행 시 출력을 억제하려면 logging rules 를 정의하거나 사용자 정의 filter 를 등록하면 됩니다.

디버깅을 위해, 심각한 오류 메시지가 발생했을 때 프로그램을 중단시키는 것이 때때로 편리합니다. 이렇게 하면 코어 덤프를 확인하거나 디버거를 연결할 수 있습니다. qFatal()도 참조하십시오. 이 기능을 활성화하려면 환경 변수 QT_FATAL_CRITICALS 을 숫자로 설정하십시오. n. 그러면 프로그램은 n번째 심각한 오류 메시지가 발생했을 때 종료됩니다. 즉, 환경 변수가 1로 설정되어 있으면 첫 번째 호출 시 종료되고, 10으로 설정되어 있으면 10번째 호출 시 종료됩니다. 환경 변수에 숫자가 아닌 값이 지정된 경우, 이는 1과 동일하게 처리됩니다.

참고: 이 매크로는 스레드 안전합니다.

QDebug::qCritical, qCCritical(), qDebug(), qInfo(), qWarning(), qFatal(), qInstallMessageHandler() 및 ‘디버깅 기법’항목도 참조하십시오 .

qDebug(const char *format, ...)

중앙 메시지 핸들러에 “ format ” 디버그 메시지를 기록합니다. ` format `에는 추가 인자로 지정된 값으로 대체되는 형식 지정자가 포함될 수 있습니다.

예시:

qDebug("Items in list: %d", myList.size());

format UTF-8 문자열의 경우 ` %s `과 같은 형식 지정자를 포함할 수 있으며, 정수의 경우 ` %i `을 사용할 수 있습니다. 이는 C 언어의 ` printf() ` 함수가 작동하는 방식과 유사합니다. 서식에 대한 자세한 내용은 ` QString::asprintf()`을 참조하십시오.

더 큰 편의성과 더 광범위한 유형 지원을 위해, 스트리밍 패러다임을 따르는 QDebug::qDebug()을 사용할 수도 있습니다( std::cout 또는 std::cerr 와 유사).

컴파일 시 QT_NO_DEBUG_OUTPUT 가 정의된 경우, 이 함수는 아무 작업도 수행하지 않습니다.

실행 시 출력을 억제하려면 qInstallMessageHandler()을 사용하여 사용자 정의 메시지 핸들러를 설정하십시오.

참고: 이 매크로는 스레드 안전합니다.

QDebug::qDebug()도 참조하십시오 . qCDebug(), qInfo(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler() 및 디버깅 기법도참조하십시오 .

qFatal(const char *format, ...)

치명적인 메시지 format 를 중앙 메시지 핸들러에 기록합니다. ` format `에는 추가 인자로 지정된 값으로 대체되는 형식 지정자가 포함될 수 있습니다.

예시:

int divide_by_zero(int a, int b)
{
    if (b == 0)                                // program error
        qFatal("divide: cannot divide by zero");
    return a / b;
}

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

실행 시 출력을 억제하려면 qInstallMessageHandler()을 사용하여 사용자 정의 메시지 핸들러를 설정하십시오.

qCFatal(), qDebug(), qInfo(), qWarning(), qCritical(), qInstallMessageHandler() 및 ‘디버깅 기법’항목도 참조하십시오 .

qInfo(const char *format, ...)

중앙 메시지 핸들러에 정보 메시지 format 를 기록합니다. ` format `에는 추가 인자로 지정된 값으로 대체되는 형식 지정자가 포함될 수 있습니다.

예시:

qInfo("Items in list: %d", myList.size());

format UTF-8 문자열의 경우 ` %s `과 같은 형식 지정자를, 정수의 경우 ` %i `과 같은 형식 지정자를 포함할 수 있습니다. 이는 C 언어의 ` printf() ` 함수가 작동하는 방식과 유사합니다. 서식에 대한 자세한 내용은 ` QString::asprintf()`을 참조하십시오.

더 큰 편의성과 광범위한 유형 지원을 위해, 스트리밍 패러다임을 따르는 QDebug::qInfo()을 사용할 수도 있습니다( std::cout 또는 std::cerr 와 유사).

컴파일 시 QT_NO_INFO_OUTPUT 가 정의된 경우, 이 함수는 아무 작업도 수행하지 않습니다.

실행 시 출력을 억제하려면 qInstallMessageHandler()을 사용하여 자체 메시지 핸들러를 설치하십시오.

참고: 이 매크로는 스레드 안전합니다.

QDebug::qInfo()도 참조하십시오 . qCInfo(), qDebug(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler() 및 디버깅 기법도참조하십시오 .

qWarning(const char *format, ...)

중앙 메시지 핸들러에 “ format ”라는 경고 메시지를 기록합니다. ` format `에는 추가 인자로 지정된 값으로 대체되는 서식 지정자가 포함될 수 있습니다.

예시:

void f(int c)
{
    if (c > 200)
        qWarning("f: bad argument, c == %d", c);
}

format UTF-8 문자열의 경우 %s, 정수의 경우 %i 과 같은 형식 지정자를 포함할 수 있습니다. 이는 C 언어의 printf() 함수가 작동하는 방식과 유사합니다. 서식에 대한 자세한 내용은 QString::asprintf()을 참조하십시오.

더 큰 편의성과 추가적인 유형 지원을 위해, 스트리밍 패러다임을 따르는 QDebug::qWarning()을 사용할 수도 있습니다( std::cout 또는 std::cerr 와 유사).

컴파일 시 QT_NO_WARNING_OUTPUT 가 정의된 경우 이 함수는 아무 작업도 수행하지 않습니다. 런타임에 출력을 억제하려면 logging rules 를 설정하거나 사용자 정의 filter 를 등록하면 됩니다.

디버깅을 위해 경고 메시지가 발생하면 프로그램이 중단되도록 하는 것이 편리한 경우가 있습니다. 이를 통해 코어 덤프를 확인하거나 디버거를 연결할 수 있습니다( qFatal()도 참조하십시오). 이 기능을 활성화하려면 환경 변수 QT_FATAL_WARNINGS 을 숫자 n 로 설정하십시오. 그러면 프로그램은 n번째 경고가 발생할 때 종료됩니다. 즉, 환경 변수가 1로 설정되어 있으면 첫 번째 호출에서 종료되고, 값이 10이면 10번째 호출에서 종료됩니다. 환경 변수에 숫자가 아닌 값이 설정되어 있으면 1로 간주됩니다.

참고: 이 매크로는 스레드 안전합니다.

QDebug::qWarning(), qCWarning(), qDebug(), qInfo(), qCritical(), qFatal(), qInstallMessageHandler() 및 디버깅 기법도 참조하십시오 .