QDebug Class

Dokumentation der Mitgliedsfunktionen

[explicit, since 6.9] QDebug::QDebug(QByteArray *byteArray)

Erstellt einen Debug-Stream, der in den angegebenen „ byteArray “ schreibt.

Die Daten werden in UTF-8 kodiert, was beispielsweise unter Windows möglicherweise nicht mit der System-Locale übereinstimmt.

Bei Objekten, die mit diesem Konstruktor instanziiert wurden, werden die Daten möglicherweise zwischengespeichert und erst dann in das Byte-Array geschrieben, wenn der Stream geleert wird, beispielsweise durch Aufruf von ` Qt::flush`.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` QTextStream manipulators`.

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

Erstellt einen Debug-Stream, der in die angegebene „ device “ schreibt.

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

Erstellt einen Debug-Stream, der in die angegebene „ string “ schreibt.

[explicit] QDebug::QDebug(QtMsgType t)

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

QDebug::QDebug(const QDebug &o)

Erstellt eine Kopie des anderen Debug-Streams o.

[noexcept] QDebug::~QDebug()

Leert alle noch ausstehenden Schreibvorgänge und löscht den Debug-Stream.

bool QDebug::autoInsertSpaces() const

Gibt „ true “ zurück, wenn diese „ QDebug “-Instanz automatisch Leerzeichen zwischen den 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 eine Referenz 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 eine Referenz auf den Stream zurück.

Siehe auch space() und nospace().

QDebug &QDebug::noquote()

Deaktiviert das automatische Einfügen von Anführungszeichen um Inhalte unter 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 Escape-Zeichen für nicht druckbare Zeichen ausgegeben.

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 Inhalte unter QChar, QString und QByteArray und gibt einen Verweis auf den Stream zurück.

Die Anführungszeichen werden standardmäßig gesetzt.

Siehe auch noquote() und maybeQuote().

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

Gibt „ true “ zurück, wenn diese „ QDebug “-Instanz die in sie eingelesenen Zeichenfolgen in Anführungszeichen setzt (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 Streams zurück und versetzt ihn damit in seinen ursprünglichen Zustand.

Siehe auch space() und quote().

void QDebug::setAutoInsertSpaces(bool b)

Aktiviert das automatische Einfügen von Leerzeichen zwischen Schreibvorgängen, wenn „ b “ auf „true“ gesetzt 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 Anführungszeichenumschaltung für Zeichenfolgen, die in diese „ QDebug “-Instanz gestreamt werden, sofern „ b “ auf „ true “ gesetzt ist; andernfalls ist die Anführungszeichenumschaltung deaktiviert.

Standardmäßig werden Zeichenfolgen in Anführungszeichen gesetzt.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

void QDebug::setVerbosity(int verbosityLevel)

Legt die Ausführlichkeit des Streams auf „ verbosityLevel “ fest.

Der zulässige Bereich liegt zwischen 0 und 7. Der Standardwert ist 2.

Siehe auch „ verbosity()“ und „ VerbosityLevel “.

QDebug &QDebug::space()

Schreibt ein Leerzeichen in den Debug-Stream und gibt eine Referenz 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)

Ersetzt diese Debug-Stream-Instanz durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[static, since 6.9] template <typename T> QByteArray QDebug::toBytes(const T &object)

Dies entspricht der Übergabe von ` object ` an ` QDebug::toString(object).toUtf8()`, ist jedoch effizienter.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch toString().

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

Leitet „ object “ in eine „ QDebug “-Instanz, die eine Zeichenkette verarbeitet, und gibt anschließend diese Zeichenkette zurück.

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

QString str = QDebug::toString(list);

Die Zeichenkette wird mit ` nospace()` gestreamt.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` toBytes()`.

int QDebug::verbosity() const

Gibt den Ausführlichkeitsgrad des Debug-Streams zurück.

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

Der zulässige Bereich liegt zwischen 0 und 7. Der Standardwert ist 2.

Siehe auch setVerbosity() und VerbosityLevel.

QDebug &QDebug::verbosity(int verbosityLevel)

Legt die Ausführlichkeitsstufe des Streams auf „ verbosityLevel “ fest und gibt eine Referenz auf den Stream zurück.

Der zulässige Bereich liegt zwischen 0 und 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 eine Referenz auf den Stream zurück.

Normalerweise gibt „ QDebug “ die Daten in Anführungszeichen aus und wandelt Steuerzeichen sowie Nicht-US-ASCII-Zeichen in ihre C-Escape-Sequenzen um (\xAB). Auf diese Weise ist die Ausgabe stets 7-Bit-kompatibel, und die Zeichenkette kann bei Bedarf aus der Ausgabe kopiert und wieder in C++-Quelldateien eingefügt werden.

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

Beispiele finden Sie in der Überladung von ` QByteArray `.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Schreibt das Zeichen „ t “ in den Stream und gibt eine Referenz auf den Stream zurück. Normalerweise gibt „ QDebug “ Steuerzeichen und Nicht-US-ASCII-Zeichen als ihre C-Escape-Sequenzen oder ihren Unicode-Wert (\u1234) aus. Um nicht druckbare Zeichen ohne Umwandlung auszugeben, aktivieren Sie die Funktion „ noquote()“. Beachten Sie jedoch, dass einige Backends von „ QDebug “ möglicherweise nicht 8-Bit-kompatibel sind und „ t “ möglicherweise nicht darstellen können.

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

Schreibt die Zeichenkette „ t “ in den Stream und gibt eine Referenz 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 auszugeben, aktivieren Sie die Funktion „ noquote()“. Beachten Sie, dass einige „ QDebug “-Backends möglicherweise nicht 8-Bit-kompatibel sind.

Beispiele finden Sie in der Überladung von ` QString `.

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

Schreibt die Zeichenfolgenansicht „ s “ in den Stream und gibt eine Referenz 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 auszugeben, aktivieren Sie die Funktion „ noquote()“. Beachten Sie, dass einige Backends von „ QDebug “ möglicherweise nicht 8-Bit-kompatibel sind.

Beispiele finden Sie in der Überladung von ` QString `.

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

Schreibt die Zeichenfolgenansicht „ s “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

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

Diese Funktion wurde in Qt 6.0 eingeführt.

Gibt die textuelle Darstellung der 128-Bit-Ganzzahl i aus.

Diese Funktionen wurden in Qt 6.7 eingeführt.

Siehe auch „ QT_SUPPORTS_INT128 “.

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

Schreibt den booleschen Wert „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt das Zeichen „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt das UTF-16-Zeichen „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt das UTF-32-Zeichen „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt das Byte-Array „ t “ in den Stream und gibt eine Referenz auf den Stream zurück. Normalerweise gibt QDebug das Array in Anführungszeichen aus und wandelt Steuerzeichen oder Nicht-US-ASCII-Zeichen in ihre C-Escape-Sequenzen um (\xAB). Auf diese Weise ist die Ausgabe stets 7-Bit-kompatibel, und die Zeichenkette kann bei Bedarf aus der Ausgabe kopiert und wieder in C++-Quellcode eingefügt werden.

Um nicht druckbare Zeichen ohne Umwandlung auszugeben, aktivieren Sie die Funktion „ noquote “ (). Beachten Sie, dass einige „ QDebug “-Backends möglicherweise nicht 8-Bit-kompatibel sind.

Ausgabebeispiele:

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";                 // Escape-Zeichen
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 auf die gleiche Weise schließen und erneut öffnen musste, wie es in den Sprachen C und C++ bei der Verkettung von Zeichenfolgenliteralen üblich ist, damit der Buchstabe „b“ nicht als Teil der vorhergehenden hexadezimalen Escape-Sequenz interpretiert wird.

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

Schreibt die Zeichenkette „ t “ in den Stream und gibt eine Referenz 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 auszugeben, aktivieren Sie die Funktion „ noquote()“. Beachten Sie, dass einige Backends von „ QDebug “ möglicherweise nicht 8-Bit-kompatibel sind.

Ausgabebeispiele:

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";               // WEICHER BINDESTRICH
qDebug() << s;              // prints: "\u00AD"

s = "\u00E1";               // KLEINER LATINISCHER BUCHSTABE A MIT AKUT
qDebug() << s;              // prints: "á"

s = "a\u0301";              // „a“, gefolgt von einem „COMBINING ACUTE ACCENT“
qDebug() << s;              // prints: "á";

s = "\u0430\u0301";         // Kyrillischer Kleinbuchstabe A, gefolgt von einem kombinierenden Akut-Akzent
qDebug() << s;              // prints: "а́"

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

Schreibt die durch „\0 “ begrenzte UTF-8-Zeichenkette „ t “ in den Stream und gibt eine Referenz auf den Stream zurück. Die Zeichenkette wird bei der Ausgabe niemals in Anführungszeichen gesetzt oder mit Escape-Zeichen versehen. Beachten Sie, dass QDebug intern als UTF-16 gepuffert wird und möglicherweise mithilfe des Codecs der Locale in 8-Bit umgewandelt werden muss, um bestimmte Backends nutzen zu können, was zu einer verstümmelten Ausgabe (Mojibake) führen kann. Es wird empfohlen, sich auf US-ASCII-Zeichenketten zu beschränken.

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

Schreibt die mit „'\0 “ abgeschlossene UTF-16-Zeichenkette „ t “ in den Stream und gibt eine Referenz auf den Stream zurück. Die Zeichenkette wird bei der Ausgabe niemals in Anführungszeichen gesetzt oder mit Escape-Zeichen versehen. Beachten Sie, dass „ QDebug “ intern als UTF-16 gepuffert wird und möglicherweise mithilfe des Codecs der Locale in 8-Bit umgewandelt werden muss, um bestimmte Backends nutzen zu können, was zu verzerrten Ausgaben (Mojibake) führen kann. Es wird empfohlen, sich auf US-ASCII-Zeichenfolgen zu beschränken.

Diese Funktion wurde in Qt 6.0 eingeführt.

Schreibt die Zeichenkette oder die Zeichenkettenansicht „ s “ in den Stream und gibt eine Referenz auf den Stream zurück.

Diese Operatoren nehmen nur dann 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 Funktionen wurden in Qt 6.5 eingeführt.

[since 6.7] template <typename T> requires if_streamable<T> QDebug &QDebug::operator<<(const std::optional<T> &opt)

Schreibt den Inhalt von opt (oder nullopt, falls nicht festgelegt) in diesen Stream. T muss das Streamen in QDebug unterstützen.

Diese Funktion wurde in Qt 6.7 eingeführt.

[since 6.9] template <typename... Ts> requires if_streamable<Ts...> QDebug &QDebug::operator<<(const std::tuple<Ts...> &tuple)

Schreibt den Inhalt von ` tuple ` in den Stream. Alle ` Ts... ` müssen das Streaming in ` QDebug` unterstützen.

Diese Funktion wurde in Qt 6.9 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 eine Referenz auf den Stream zurück.

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

Schreibt die 32-Bit-Gleitkommazahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete Ganzzahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete lange Ganzzahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete 64-Bit-Ganzzahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt die vorzeichenlose 64-Bit-Ganzzahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt die vorzeichenbehaftete kurze Ganzzahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Gibt die Zeitdauer „ duration “ in den Stream aus und gibt eine Referenz auf den Stream zurück. Die ausgegebene Zeichenkette ist die numerische Darstellung der Dauer, gefolgt von der Zeiteinheit, ähnlich wie es die C++-Standardbibliothek 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 die vorzeichenlose Ganzzahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt die unsignierte Long-Ganzzahl „ t “ in den Stream und gibt einen Verweis auf den Stream zurück.

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

Schreibt die vorzeichenlose kurze Ganzzahl „ t “ in den Stream und gibt eine Referenz auf den Stream zurück.

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

Weist diesem Stream den Debug-Stream „ other “ zu und gibt eine Referenz auf diesen Stream zurück.