QDebug Class

Dokumentation der Mitgliedsfunktionen

Schreibt den String oder die String-Ansicht s in den Stream und gibt einen Verweis auf den Stream zurück.

Diese Operatoren nehmen nur an der Überladungsauflösung teil, wenn Char einer der folgenden Werte ist

• char
• char8_t (nur C++20)
• char16_t
• char32_t
• wchar_t

Diese Funktion wurde in Qt 6.5 eingeführt.

Druckt die textuelle Darstellung der 128-Bit Ganzzahl i.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QT_SUPPORTS_INT128.

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

Konstruiert einen Debug-Stream, der in den angegebenen device schreibt.

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

Konstruiert einen Debug-Stream, der in den angegebenen string schreibt.

[explicit] QDebug::QDebug(QtMsgType t)

Konstruiert einen Debug-Stream, der in den Handler für den Nachrichtentyp t schreibt.

QDebug::QDebug(const QDebug &o)

Konstruiert eine Kopie des anderen Debug-Streams o.

[noexcept] QDebug::~QDebug()

Leert alle anstehenden Daten, die geschrieben werden sollen, und zerstört den Debug-Stream.

bool QDebug::autoInsertSpaces() const

Gibt true zurück, wenn diese QDebug Instanz automatisch Leerzeichen zwischen Schreibvorgängen einfügt.

Siehe auch setAutoInsertSpaces() und QDebugStateSaver.

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

Schreibt ein Zeichen c in den Debug-Stream, abhängig von der aktuellen Einstellung für das automatische Einfügen von Anführungszeichen, und gibt einen Verweis auf den Stream zurück.

Das Standardzeichen ist ein doppeltes Anführungszeichen ".

Siehe auch quote() und noquote().

QDebug &QDebug::maybeSpace()

Schreibt ein Leerzeichen in den Debug-Stream, abhängig von der aktuellen Einstellung für das automatische Einfügen von Leerzeichen, und gibt einen Verweis auf den Stream zurück.

Siehe auch space() und nospace().

QDebug &QDebug::noquote()

Deaktiviert das automatische Einfügen von Anführungszeichen um den Inhalt von QChar, QString und QByteArray und gibt einen Verweis auf den Stream zurück.

Wenn die Anführungszeichen deaktiviert sind, werden diese Typen ohne Anführungszeichen und ohne Escaping von nicht druckbaren Zeichen gedruckt.

Siehe auch quote() und maybeQuote().

QDebug &QDebug::nospace()

Deaktiviert das automatische Einfügen von Leerzeichen und gibt einen Verweis auf den Stream zurück.

Siehe auch space() und maybeSpace().

QDebug &QDebug::quote()

Aktiviert das automatische Einfügen von Anführungszeichen um den Inhalt von QChar, QString und QByteArray und gibt einen Verweis auf den Stream zurück.

Die Anführungszeichen sind standardmäßig aktiviert.

Siehe auch noquote() und maybeQuote().

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

Gibt true zurück, wenn diese QDebug Instanz Strings zitiert, die in sie hineingestreamt werden (was die Standardeinstellung ist).

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QDebugStateSaver, quote(), noquote(), und setQuoteStrings().

QDebug &QDebug::resetFormat()

Setzt die Formatierungsoptionen des Datenstroms zurück, so dass er wieder in seinen ursprünglichen Zustand versetzt wird.

Siehe auch space() und quote().

void QDebug::setAutoInsertSpaces(bool b)

Aktiviert das automatische Einfügen von Leerzeichen zwischen Schreibvorgängen, wenn b wahr ist; andernfalls ist das automatische Einfügen von Leerzeichen deaktiviert.

Siehe auch autoInsertSpaces() und QDebugStateSaver.

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

Aktiviert die Quotierung von Strings, die in diese QDebug Instanz gestreamt werden, wenn b true ist; andernfalls ist die Quotierung deaktiviert.

Die Vorgabe ist, dass Strings zitiert werden.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QDebugStateSaver, quote(), noquote(), und quoteStrings().

void QDebug::setVerbosity(int verbosityLevel)

Setzt die Ausführlichkeit des Streams auf verbosityLevel.

Der zulässige Bereich reicht von 0 bis 7. Der Standardwert ist 2.

Siehe auch verbosity() und VerbosityLevel.

QDebug &QDebug::space()

Schreibt ein Leerzeichen in den Debug-Stream und gibt einen Verweis auf den Stream zurück.

Der Stream merkt sich, dass das automatische Einfügen von Leerzeichen für zukünftige Schreibvorgänge aktiviert ist.

Siehe auch nospace() und maybeSpace().

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

Tauscht diese Debug-Stream-Instanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

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

Streamt object in eine Instanz von QDebug, die eine Zeichenkette verarbeitet, und gibt diese Zeichenkette dann zurück.

Diese Funktion ist nützlich für Fälle, in denen Sie die textuelle Darstellung eines Objekts zum Debuggen benötigen, aber operator<< nicht verwenden können. Ein Beispiel:

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

Der String wird mit nospace() gestreamt.

Diese Funktion wurde in Qt 6.0 eingeführt.

int QDebug::verbosity() const

Gibt die Ausführlichkeit des Debug-Streams zurück.

Streaming-Operatoren können den Wert überprüfen, um zu entscheiden, ob eine ausführliche Ausgabe erwünscht ist, und je nach Stufe mehr Informationen ausgeben. Höhere Werte zeigen an, dass mehr Informationen erwünscht sind.

Der zulässige Bereich reicht von 0 bis 7. Der Standardwert ist 2.

Siehe auch setVerbosity() und VerbosityLevel.

QDebug &QDebug::verbosity(int verbosityLevel)

Setzt die Ausführlichkeit des Streams auf verbosityLevel und gibt einen Verweis auf den Stream zurück.

Der zulässige Bereich reicht von 0 bis 7. Der Standardwert ist 2.

Siehe auch verbosity(), setVerbosity(), und VerbosityLevel.

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

Schreibt die Daten des beobachteten Byte-Arrays, t, in den Stream und gibt einen Verweis auf den Stream zurück.

Normalerweise gibt QDebug die Daten in Anführungszeichen aus und wandelt Steuer- oder Nicht-US-ASCII-Zeichen in ihre C-Escape-Sequenzen (\xAB) um. Auf diese Weise ist die Ausgabe immer 7-Bit sauber und die Zeichenkette kann von der Ausgabe kopiert und bei Bedarf wieder in C++-Quellen eingefügt werden.

Um nicht druckbare Zeichen ohne Umwandlung zu drucken, aktivieren Sie die Funktion noquote(). Beachten Sie, dass einige QDebug Backends möglicherweise nicht 8-Bit sauber sind.

Siehe die Überladung QByteArray für Beispiele.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Schreibt das Zeichen t in den Stream und gibt einen Verweis auf den Stream zurück. Normalerweise druckt QDebug Steuerzeichen und Nicht-US-ASCII-Zeichen als ihre C-Escape-Sequenzen oder ihren Unicode-Wert (\u1234). Um nicht druckbare Zeichen ohne Umwandlung zu drucken, aktivieren Sie die Funktion noquote(), aber beachten Sie, dass einige QDebug Backends möglicherweise nicht 8-Bit sauber sind und t nicht darstellen können.

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

Schreibt die Zeichenkette t in den Stream und gibt einen Verweis auf den Stream zurück. Normalerweise druckt QDebug die Zeichenkette in Anführungszeichen und wandelt nicht druckbare Zeichen in ihre Unicode-Werte um (\u1234).

Um nicht druckbare Zeichen ohne Umwandlung zu drucken, aktivieren Sie die Funktion noquote(). Beachten Sie, dass einige QDebug Backends möglicherweise nicht 8-bit sauber sind.

Siehe die Überladung QString für Beispiele.

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

Schreibt die Zeichenkettenansicht s in den Stream und gibt einen Verweis auf den Stream zurück. Normalerweise gibt QDebug die Zeichenkette in Anführungszeichen aus und wandelt nicht druckbare Zeichen in ihre Unicode-Werte um (\u1234).

Um nicht druckbare Zeichen ohne Umwandlung zu drucken, aktivieren Sie die Funktion noquote(). Beachten Sie, dass einige QDebug Backends möglicherweise nicht 8-bit sauber sind.

Siehe die Überladung QString für Beispiele.

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

Schreibt die Zeichenkettenansicht s in den Stream und gibt einen Verweis auf den Stream zurück.

Normalerweise gibt QDebug die Daten innerhalb von Anführungszeichen aus und wandelt Steuer- oder Nicht-US-ASCII-Zeichen in ihre C-Escape-Sequenzen (\xAB) um. Auf diese Weise ist die Ausgabe immer 7-Bit sauber und die Zeichenkette kann von der Ausgabe kopiert und bei Bedarf wieder in C++-Quellen eingefügt werden.

Um nicht druckbare Zeichen ohne Umwandlung zu drucken, aktivieren Sie die Funktion noquote(). Beachten Sie, dass einige QDebug Backends möglicherweise nicht 8-Bit sauber sind.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Schreibt den booleschen Wert t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt das Zeichen t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt das UTF-16-Zeichen t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt das UTF-32-Zeichen t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt das Byte-Array t in den Stream und gibt einen Verweis auf den Stream zurück. Normalerweise gibt QDebug das Array in Anführungszeichen aus und wandelt Steuer- oder Nicht-US-ASCII-Zeichen in ihre C-Escape-Sequenzen (\xAB) um. Auf diese Weise ist die Ausgabe immer 7-Bit sauber und die Zeichenkette kann von der Ausgabe kopiert und bei Bedarf wieder in C++-Quellen eingefügt werden.

Um nicht druckbare Zeichen ohne Umwandlung zu drucken, aktivieren Sie die Funktion noquote(). Beachten Sie, dass einige QDebug Backends möglicherweise nicht 8-Bit sauber sind.

Beispiele für die Ausgabe:

    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"; // Fluchtzeichen    qDebug() << ba;              // prints: "\x1B"

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

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

Beachten Sie, dass QDebug die Zeichenkette in der Art und Weise schließen und wieder öffnen musste, wie die Sprachen C und C++ Zeichenkettenliterale verketten, damit der Buchstabe "b" nicht als Teil der vorherigen hexadezimalen Escape-Sequenz interpretiert wird.

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

Schreibt die Zeichenkette t in den Stream und gibt einen Verweis auf den Stream zurück. Normalerweise gibt QDebug die Zeichenfolge in Anführungszeichen aus und wandelt nicht druckbare Zeichen in ihre Unicode-Werte um (\u1234).

Um nicht druckbare Zeichen ohne Umwandlung zu drucken, aktivieren Sie die Funktion noquote(). Beachten Sie, dass einige QDebug Backends möglicherweise nicht 8-bit sauber sind.

Beispiele für die Ausgabe:

    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"; // Escape-Zeichen    qDebug() << s;              // prints: "\u001B"

    s = "\u00AD"; // SOFT HYPHEN    qDebug() << s;              // prints: "\u00AD"

    s = "\u00E1"; // KLEINER BUCHSTABEN A MIT SCHRITT    qDebug() << s;              // prints: "á"

    s = "a\u0301"; // "a" gefolgt von einem KOMBINATIONSAKZENT    qDebug() << s;              // prints: "á";

    s = "\u0430\u0301"; // ZYRILLISCHER KLEINBUCHSTABEN A gefolgt von KOMBINIERENDEM AKZENT    qDebug() << s;              // prints: "а́"

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

Schreibt die UTF-8-Zeichenkette mit der Endung '\0', t, in den Stream und gibt einen Verweis auf den Stream zurück. Die Zeichenkette wird für die Ausgabe niemals in Anführungszeichen gesetzt oder escaped. Beachten Sie, dass QDebug intern als UTF-16 gepuffert wird und möglicherweise mit dem Codec des Gebietsschemas in 8-Bit transformiert werden muss, um einige Backends zu verwenden, was zu einer verstümmelten Ausgabe führen kann (mojibake). Es wird empfohlen, sich auf US-ASCII-Strings zu beschränken.

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

Schreibt die u'\0'-terminierte UTF-16-Zeichenkette, t, in den Stream und gibt einen Verweis auf den Stream zurück. Die Zeichenkette wird für die Ausgabe nie in Anführungszeichen gesetzt oder escaped. Beachten Sie, dass QDebug intern als UTF-16 puffert und möglicherweise mit dem Codec des Gebietsschemas in 8-Bit transformiert werden muss, um einige Backends zu verwenden, was zu einer verstümmelten Ausgabe führen kann (mojibake). Es wird empfohlen, sich auf US-ASCII-Strings zu beschränken.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Schreibt einen Zeiger, t, in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt die 64-Bit-Gleitkommazahl t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt die 32-Bit-Gleitkommazahl t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete Ganzzahl t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete lange Ganzzahl t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete 64-Bit-Ganzzahl t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt dann die vorzeichenlose 64-Bit-Ganzzahl t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete kurze Ganzzahl t in den Stream und gibt einen Verweis auf den Stream zurück.

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

Druckt die Zeitdauer duration in den Stream und gibt einen Verweis auf den Stream zurück. Die gedruckte Zeichenkette ist die numerische Darstellung der Zeitdauer, gefolgt von der Zeiteinheit, ähnlich dem, was die C++ Standard Library mit std::ostream erzeugen würde.

Die Einheit ist nicht lokalisiert.

Diese Funktion wurde in Qt 6.6 eingeführt.

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

Schreibt nullopt in den Stream.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

Schreibt eine ganze Zahl ohne Vorzeichen, t, in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt dann unsigned long integer, t, in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt dann unsigned short integer, t, in den Stream und gibt eine Referenz auf den Stream zurück.

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

Weist den Debug-Stream other diesem Stream zu und gibt einen Verweis auf diesen Stream zurück.