QDebug Class

멤버 함수 문서

문자열 또는 문자열 보기 s 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

이러한 연산자는 Char 가 다음 중 하나인 경우에만 과부하 해결에 참여합니다.

• char
• char8_t(C++20만 해당)
• char16_t
• char32_t
• wchar_t

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

128비트 정수의 텍스트 표현을 출력합니다 i.

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

QT_SUPPORTS_INT128 를참조하십시오 .

[explicit] QDebug::QDebug(QIODevice *device)

주어진 device 에 기록하는 디버그 스트림을 생성합니다.

[explicit] QDebug::QDebug(QString *string)

주어진 string 에 기록하는 디버그 스트림을 생성합니다.

[explicit] QDebug::QDebug(QtMsgType t)

메시지 유형 t 에 대한 핸들러에 기록하는 디버그 스트림을 구성합니다.

QDebug::QDebug(const QDebug &o)

다른 디버그 스트림의 복사본을 생성합니다 o.

[noexcept] QDebug::~QDebug()

쓰기 보류 중인 데이터를 모두 플러시하고 디버그 스트림을 삭제합니다.

bool QDebug::autoInsertSpaces() const

QDebug 인스턴스가 쓰기 사이에 자동으로 공백을 삽입하는 경우 true 을 반환합니다.

setAutoInsertSpaces() 및 QDebugStateSaver도 참조하세요 .

QDebug &QDebug::maybeQuote(char c = '"')

따옴표 자동 삽입에 대한 현재 설정에 따라 c 문자를 디버그 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

기본 문자는 큰따옴표 " 입니다.

quote() 및 noquote()도 참조하세요 .

QDebug &QDebug::maybeSpace()

공백 자동 삽입에 대한 현재 설정에 따라 디버그 스트림에 공백 문자를 쓰고 스트림에 대한 참조를 반환합니다.

space() 및 nospace()도 참조하세요 .

QDebug &QDebug::noquote()

QChar, QString 및 QByteArray 콘텐츠 주위에 따옴표 문자를 자동으로 삽입하지 않도록 설정하고 스트림에 대한 참조를 반환합니다.

인용이 비활성화되면 이러한 유형은 따옴표 문자 없이 인쇄할 수 없는 문자를 이스케이프 처리하지 않고 인쇄됩니다.

quote() 및 maybeQuote()도 참조하세요 .

QDebug &QDebug::nospace()

공백 자동 삽입을 비활성화하고 스트림에 대한 참조를 반환합니다.

space() 및 maybeSpace()도 참조하세요 .

QDebug &QDebug::quote()

QChar, QString 및 QByteArray 콘텐츠 주위에 따옴표 문자를 자동으로 삽입하고 스트림에 대한 참조를 반환합니다.

인용은 기본적으로 활성화되어 있습니다.

noquote() 및 maybeQuote()도 참조하세요 .

[noexcept, since 6.7] bool QDebug::quoteStrings() const

QDebug 인스턴스로 스트리밍된 문자열을 인용할 경우 true 을 반환합니다(기본값).

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

QDebugStateSaver, quote(), noquote() 및 setQuoteStrings()도 참조하십시오 .

QDebug &QDebug::resetFormat()

스트림 서식 지정 옵션을 재설정하여 원래 구성된 상태로 되돌립니다.

space() 및 quote()도 참조하세요 .

void QDebug::setAutoInsertSpaces(bool b)

b 이 참이면 쓰기 사이에 공백을 자동으로 삽입하고, 그렇지 않으면 공백 자동 삽입을 비활성화합니다.

autoInsertSpaces() 및 QDebugStateSaver도 참조하세요 .

[since 6.7] void QDebug::setQuoteStrings(bool b)

b 이 true 인 경우 이 QDebug 인스턴스로 스트리밍된 문자열의 인용을 활성화하고, 그렇지 않으면 인용을 비활성화합니다.

기본값은 문자열을 인용하는 것입니다.

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

QDebugStateSaver, quote(), noquote() 및 quoteStrings()도 참조하십시오 .

void QDebug::setVerbosity(int verbosityLevel)

스트림의 상세도를 verbosityLevel 로 설정합니다.

허용 범위는 0에서 7까지입니다. 기본값은 2입니다.

verbosity() 및 VerbosityLevel도 참조하세요 .

QDebug &QDebug::space()

디버그 스트림에 공백 문자를 쓰고 스트림에 대한 참조를 반환합니다.

스트림은 향후 쓰기를 위해 공백 자동 삽입이 활성화되어 있음을 기억합니다.

nospace() 및 maybeSpace()도 참조하세요 .

[noexcept] void QDebug::swap(QDebug &other)

이 디버그 스트림 인스턴스를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

[static, since 6.0] template <typename T> QString QDebug::toString(const T &object)

object 을 문자열에 대해 연산하는 QDebug 인스턴스로 스트리밍한 다음 해당 문자열을 반환합니다.

이 함수는 디버깅을 위해 객체의 텍스트 표현이 필요하지만 operator<< 을 사용할 수 없는 경우에 유용합니다. 예를 들어

    QTRY_VERIFY2(list.isEmpty(), qPrintable(QString::fromLatin1(
        "Expected list to be empty, but it has the following items: %1")).arg(QDebug::toString(list)));

nospace()를 사용하여 문자열을 스트리밍합니다.

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

int QDebug::verbosity() const

디버그 스트림의 상세도를 반환합니다.

스트리밍 운영자는 이 값을 확인하여 자세한 정보 출력을 원하는지 여부를 결정하고 수준에 따라 더 많은 정보를 출력할 수 있습니다. 값이 클수록 더 많은 정보를 원한다는 뜻입니다.

허용 범위는 0에서 7까지입니다. 기본값은 2입니다.

setVerbosity() 및 VerbosityLevel 을참조하세요 .

QDebug &QDebug::verbosity(int verbosityLevel)

스트림의 상세도를 verbosityLevel 로 설정하고 스트림에 대한 참조를 반환합니다.

허용 범위는 0에서 7까지입니다. 기본값은 2입니다.

verbosity(), setVerbosity() 및 VerbosityLevel 를참조하세요 .

[since 6.0] QDebug &QDebug::operator<<(QByteArrayView t)

관찰된 바이트 배열( t)의 데이터를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

일반적으로 QDebug 은 따옴표 안에 데이터를 인쇄하고 제어 문자나 US-ASCII가 아닌 문자를 해당 C 이스케이프 시퀀스(\xAB)로 변환합니다. 이렇게 하면 출력은 항상 7비트로 깔끔하게 출력되며, 필요한 경우 출력에서 문자열을 복사하여 C++ 소스에 다시 붙여넣을 수 있습니다.

인쇄할 수 없는 문자를 변환하지 않고 인쇄하려면 noquote() 기능을 활성화하세요. 일부 QDebug 백엔드는 8비트 정리가 되지 않을 수 있습니다.

예제는 QByteArray 과부하를 참조하세요.

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

QDebug &QDebug::operator<<(QChar t)

t 문자를 스트림에 쓰고 스트림에 대한 참조를 반환합니다. 일반적으로 QDebug 은 제어 문자 및 US-ASCII가 아닌 문자를 C 이스케이프 시퀀스 또는 유니코드 값(\u1234)으로 인쇄합니다. 인쇄할 수 없는 문자를 변환하지 않고 인쇄하려면 noquote() 기능을 활성화하지만 일부 QDebug 백엔드는 8비트 정리가 되지 않아 t 를 표현하지 못할 수 있습니다.

QDebug &QDebug::operator<<(QLatin1StringView t)

t 문자열을 스트림에 쓰고 스트림에 대한 참조를 반환합니다. 일반적으로 QDebug 는 따옴표 안에 문자열을 인쇄하고 인쇄할 수 없는 문자를 해당 유니코드 값(\u1234)으로 변환합니다.

인쇄할 수 없는 문자를 변환하지 않고 인쇄하려면 noquote() 기능을 활성화합니다. 일부 QDebug 백엔드는 8비트 정리가 되지 않을 수 있습니다.

예는 QString 과부하를 참조하세요.

QDebug &QDebug::operator<<(QStringView s)

문자열 보기 s 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다. 일반적으로 QDebug 은 따옴표 안에 문자열을 인쇄하고 인쇄할 수 없는 문자를 해당 유니코드 값(\u1234)으로 변환합니다.

인쇄할 수 없는 문자를 변환하지 않고 인쇄하려면 noquote() 기능을 활성화합니다. 일부 QDebug 백엔드는 8비트 정리가 되지 않을 수 있습니다.

예는 QString 과부하를 참조하세요.

[since 6.0] QDebug &QDebug::operator<<(QUtf8StringView s)

문자열 보기 s 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

일반적으로 QDebug 은 따옴표 안에 데이터를 인쇄하고 제어 문자나 US-ASCII가 아닌 문자를 해당 C 이스케이프 시퀀스(\xAB)로 변환합니다. 이렇게 하면 출력은 항상 7비트로 깔끔하게 출력되며, 필요한 경우 출력에서 문자열을 복사하여 C++ 소스에 다시 붙여넣을 수 있습니다.

인쇄할 수 없는 문자를 변환하지 않고 인쇄하려면 noquote() 기능을 활성화하세요. 일부 QDebug 백엔드는 8비트 정리가 되지 않을 수 있습니다.

이 기능은 Qt 6.0에 도입되었습니다.

QDebug &QDebug::operator<<(bool t)

부울 값 t 을 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(char t)

t 이라는 문자를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(char16_t t)

UTF-16 문자 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(char32_t t)

UTF-32 문자 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(const QByteArray &t)

바이트 배열 t 을 스트림에 쓰고 스트림에 대한 참조를 반환합니다. 일반적으로 QDebug 은 배열을 따옴표 안에 인쇄하고 제어 문자나 US-ASCII가 아닌 문자를 해당 C 이스케이프 시퀀스(\xAB)로 변환합니다. 이렇게 하면 출력은 항상 7비트로 깨끗하게 유지되며, 필요한 경우 출력에서 문자열을 복사하여 C++ 소스에 다시 붙여넣을 수 있습니다.

인쇄할 수 없는 문자를 변환하지 않고 인쇄하려면 noquote() 기능을 활성화하세요. 일부 QDebug 백엔드는 8비트 정리가 되지 않을 수 있습니다.

출력 예시:

    QByteArray ba; ba = "a";    qDebug().noquote() << ba;    // prints: a
    qDebug() << ba;              // prints: "a"

    ba = "\"a\r\n\"";    qDebug() << ba;              // prints: "\"a\r\n\""

    ba = "\033"; // 이스케이프 문자    qDebug() << ba;              // prints: "\x1B"

    ba = "\xC3\xA1";    qDebug() << ba;              // prints: "\xC3\xA1"

    ba = QByteArray("a\0b", 3);    qDebug() << ba               // prints: "\a\x00""b"

문자 'b'가 이전 16진수 이스케이프 시퀀스의 일부로 해석되지 않도록 C 및 C++ 언어가 문자열 리터럴을 연결하는 방식에서 QDebug 문자열을 닫았다가 다시 열어야 하는 방식에 유의하세요.

QDebug &QDebug::operator<<(const QString &t)

t 문자열을 스트림에 쓰고 스트림에 대한 참조를 반환합니다. 일반적으로 QDebug 은 따옴표 안에 문자열을 인쇄하고 인쇄할 수 없는 문자를 해당 유니코드 값(\u1234)으로 변환합니다.

인쇄할 수 없는 문자를 변환하지 않고 인쇄하려면 noquote() 기능을 활성화합니다. 일부 QDebug 백엔드는 8비트 정리가 되지 않을 수 있습니다.

출력 예제:

    QString s; s = "a";    qDebug().noquote() << s;    // prints: a
    qDebug() << s;              // prints: "a"

    s = "\"a\r\n\"";    qDebug() << s;              // prints: "\"a\r\n\""

    s = "\033"; // 이스케이프 문자    qDebug() << s;              // prints: "\u001B"

    s = "\u00AD"; // 소프트 하이픈    qDebug() << s;              // prints: "\u00AD"

    s = "\u00E1"; // 라틴어 소문자 A와 액센트    qDebug() << s;              // prints: "á"

    s = "a\u0301"; // "a" 뒤에 악센트 악센트를 결합합니다.    qDebug() << s;              // prints: "á";

    s = "\u0430\u0301"; // 키릴 소문자 A와 악센트 악센트 결합    qDebug() << s;              // prints: "а́"

QDebug &QDebug::operator<<(const char *t)

'\0'으로 끝나는 UTF-8 문자열 t 을 스트림에 쓰고 스트림에 대한 참조를 반환합니다. 이 문자열은 출력 시 따옴표로 묶이거나 이스케이프 처리되지 않습니다. QDebug 은 내부적으로 UTF-16으로 버퍼링되며 일부 백엔드를 사용하기 위해 로캘의 코덱을 사용하여 8비트로 변환해야 할 수 있으며, 이로 인해 왜곡된 출력(모지브레이크)이 발생할 수 있습니다. US-ASCII 문자열로 제한하는 것이 좋습니다.

[since 6.0] QDebug &QDebug::operator<<(const char16_t *t)

u'\0'으로 끝나는 UTF-16 문자열 t 을 스트림에 쓰고 스트림에 대한 참조를 반환합니다. 문자열은 출력 시 따옴표로 묶이거나 이스케이프 처리되지 않습니다. QDebug 은 내부적으로 UTF-16으로 버퍼링되며 일부 백엔드를 사용하기 위해 로캘의 코덱을 사용하여 8비트로 변환해야 할 수 있으며, 이로 인해 왜곡된 출력(모지브레이크)이 발생할 수 있습니다. US-ASCII 문자열로 제한하는 것이 좋습니다.

이 기능은 Qt 6.0에 도입되었습니다.

QDebug &QDebug::operator<<(const void *t)

스트림에 대한 포인터( t)를 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(double t)

64비트 부동 소수점 숫자 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(float t)

32비트 부동 소수점 숫자 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(int t)

부호화된 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(long t)

부호화된 긴 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(qint64 t)

부호화된 64비트 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(quint64 t)

부호 없는 64비트 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(short t)

부호화된 짧은 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

[since 6.6] template <typename Rep, typename Period> QDebug &QDebug::operator<<(std::chrono::duration<Rep, Period> duration)

시간 기간 duration 을 스트림에 인쇄하고 스트림에 대한 참조를 반환합니다. 인쇄된 문자열은 C++ 표준 라이브러리에서 std::ostream 을 사용하여 생성하는 것과 유사하게 기간 뒤에 시간 단위를 숫자로 표현한 것입니다.

단위는 지역화되지 않습니다.

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

[since 6.7] QDebug &QDebug::operator<<(std::nullopt_t)

스트림에 널 옵트를 씁니다.

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

QDebug &QDebug::operator<<(unsigned int t)

부호 없는 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(unsigned long t)

그런 다음 부호 없는 긴 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator<<(unsigned short t)

부호 없는 짧은 정수 t 를 스트림에 쓰고 스트림에 대한 참조를 반환합니다.

QDebug &QDebug::operator=(const QDebug &other)

other 디버그 스트림을 이 스트림에 할당하고 이 스트림에 대한 참조를 반환합니다.