Struct qt_core::QDebug

The QDebug class provides an output stream for debugging information.

QDebug is used whenever the developer needs to write out debugging or tracing information to a device, file, string or console.

Implementations§

See also quote() and noquote().

pub unsafe fn maybe_quote_0a(&self) -> Ref<QDebug>

Writes a character c to the debug stream, depending on the current setting for automatic insertion of quotes, and returns a reference to the stream.

Calls C++ function: QDebug& QDebug::maybeQuote().

Writes a character c to the debug stream, depending on the current setting for automatic insertion of quotes, and returns a reference to the stream.

The default character is a double quote ".

This function was introduced in Qt 5.4.

See also quote() and noquote().

pub unsafe fn maybe_space(&self) -> Ref<QDebug>

Writes a space character to the debug stream, depending on the current setting for automatic insertion of spaces, and returns a reference to the stream.

See also quote() and maybeQuote().

pub unsafe fn nospace(&self) -> Ref<QDebug>

Disables automatic insertion of spaces and returns a reference to the stream.

Calls C++ function: QDebug& QDebug::nospace().

Disables automatic insertion of spaces and returns a reference to the stream.

See also space() and maybeSpace().

pub unsafe fn quote(&self) -> Ref<QDebug>

Enables automatic insertion of quotation characters around QChar, QString and QByteArray contents and returns a reference to the stream.

Calls C++ function: QDebug& QDebug::quote().

Enables automatic insertion of quotation characters around QChar, QString and QByteArray contents and returns a reference to the stream.

Quoting is enabled by default.

This function was introduced in Qt 5.4.

See also noquote() and maybeQuote().

pub unsafe fn reset_format(&self) -> Ref<QDebug>

Resets the stream formatting options, bringing it back to its original constructed state.

Calls C++ function: QDebug& QDebug::resetFormat().

Resets the stream formatting options, bringing it back to its original constructed state.

This function was introduced in Qt 5.4.

See also space() and quote().

pub unsafe fn set_auto_insert_spaces(&self, b: bool)

Enables automatic insertion of spaces between writes if b is true; otherwise automatic insertion of spaces is disabled.

Calls C++ function: void QDebug::setAutoInsertSpaces(bool b).

Enables automatic insertion of spaces between writes if b is true; otherwise automatic insertion of spaces is disabled.

This function was introduced in Qt 5.0.

See also autoInsertSpaces() and QDebugStateSaver.

pub unsafe fn set_verbosity(&self, verbosity_level: c_int)

Sets the verbosity of the stream to verbosityLevel.

Calls C++ function: void QDebug::setVerbosity(int verbosityLevel).

pub unsafe fn swap(&self, other: impl CastInto<Ref<QDebug>>)

Swaps this debug stream instance with other. This function is very fast and never fails.

Calls C++ function: void QDebug::swap(QDebug& other).

Swaps this debug stream instance with other. This function is very fast and never fails.

This function was introduced in Qt 5.0.

pub unsafe fn verbosity(&self) -> c_int

Returns the verbosity of the debug stream.

Calls C++ function: int QDebug::verbosity() const.

Returns the verbosity of the debug stream.

Streaming operators can check the value to decide whether verbose output is desired and print more information depending on the level. Higher values indicate that more information is desired.

The allowed range is from 0 to 7. The default value is 2.

This function was introduced in Qt 5.6.

See also setVerbosity().

pub unsafe fn verbosity_mut(&self, verbosity_level: c_int) -> Ref<QDebug>

Available on cpp_lib_version="5.13.0" or cpp_lib_version="5.14.0" only.

Sets the verbosity of the stream to verbosityLevel and returns a reference to the stream.

Calls C++ function: QDebug& QDebug::verbosity(int verbosityLevel).

Sets the verbosity of the stream to verbosityLevel and returns a reference to the stream.

The allowed range is from 0 to 7. The default value is 2.

This function was introduced in Qt 5.13.

See also verbosity(), setVerbosity(), and VerbosityLevel.

Trait Implementations§

impl CppDeletable for QDebug

unsafe fn delete(&self)

fn shl(self, flags: QFlags<ComponentFormattingOption>) -> CppBox<QDebug>

Writes bit array ba to stream out.

Calls C++ function: QDebug operator<<(QDebug debug, const QFlags<QUrl::ComponentFormattingOption>& flags).

Warning: no exact match found in C++ documentation. Below is the C++ documentation for QDataStream &operator<<(QDataStream &out, const QBitArray &ba):

Writes bit array ba to stream out.

type Output = CppBox<QDebug>

The resulting type after applying the << operator.

impl Shl<QFlags<ConversionFlag>> for &QDebug

fn shl(self, flags: QFlags<ConversionFlag>) -> CppBox<QDebug>

Writes bit array ba to stream out.

Calls C++ function: QDebug operator<<(QDebug debug, const QFlags<QTextCodec::ConversionFlag>& flags).

Warning: no exact match found in C++ documentation. Below is the C++ documentation for QDataStream &operator<<(QDataStream &out, const QBitArray &ba):

impl Shl<QFlags<SplitBehaviorFlags>> for &QDebug

impl Shl<Ref<QByteArray>> for &QDebug

fn shl(self, t: Ref<QByteArray>) -> Ref<QDebug>

Writes the byte array, b, to the stream and returns a reference to the stream. Normally, QDebug prints the array inside quotes and transforms control or non-US-ASCII characters to their C escape sequences (\xAB). This way, the output is always 7-bit clean and the string can be copied from the output and pasted back into C++ sources, if necessary.

Calls C++ function: QDebug& QDebug::operator<<(const QByteArray& t).

Writes the byte array, b, to the stream and returns a reference to the stream. Normally, QDebug prints the array inside quotes and transforms control or non-US-ASCII characters to their C escape sequences (\xAB). This way, the output is always 7-bit clean and the string can be copied from the output and pasted back into C++ sources, if necessary.

To print non-printable characters without transformation, enable the noquote() functionality. Note that some QDebug backends might not be 8-bit clean.

Output examples:

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 character
qDebug() << ba;              // prints: “\x1B”
ba = “\xC3\xA1”;
qDebug() << ba;              // prints: “\xC3\xA1”
ba = QByteArray(“a\0b”, 3);
qDebug() << ba               // prints: “\a\x00”“b”

impl Shl<Ref<QFileInfo>> for &QDebug

impl Shl<Ref<QLatin1String>> for &QDebug

impl Shl<Ref<QListOfQFileInfo>> for &QDebug

impl Shl<Ref<QListOfQStorageInfo>> for &QDebug

impl Shl<Ref<QOperatingSystemVersion>> for &QDebug

impl Shl<Ref<QStorageInfo>> for &QDebug

Available on cpp_lib_version="5.11.3" or cpp_lib_version="5.12.2" or cpp_lib_version="5.13.0" or cpp_lib_version="5.14.0" only.

fn shl(self, arg2: Ref<QStorageInfo>) -> CppBox<QDebug>

Writes bit array ba to stream out.

Calls C++ function: QDebug operator<<(QDebug debug, const QStorageInfo& arg2).

Warning: no exact match found in C++ documentation. Below is the C++ documentation for QDataStream &operator<<(QDataStream &out, const QBitArray &ba):

Writes bit array ba to stream out.

type Output = CppBox<QDebug>

The resulting type after applying the << operator.

impl Shl<Ref<QString>> for &QDebug

fn shl(self, t: Ref<QString>) -> Ref<QDebug>

Writes the string, s, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\u1234).

Calls C++ function: QDebug& QDebug::operator<<(const QString& t).

Writes the string, s, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\u1234).

To print non-printable characters without transformation, enable the noquote() functionality. Note that some QDebug backends might not be 8-bit clean.

Output examples:

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 character
qDebug() << s;              // prints: “\u001B”
s = “\u00AD”;               // SOFT HYPHEN
qDebug() << s;              // prints: “\u00AD”
s = “\u00E1”;               // LATIN SMALL LETTER A WITH ACUTE
qDebug() << s;              // prints: “á”
s = “a\u0301”;              // “a” followed by COMBINING ACUTE ACCENT
qDebug() << s;              // prints: “á”;
s = “\u0430\u0301”;         // CYRILLIC SMALL LETTER A followed by COMBINING ACUTE ACCENT
qDebug() << s;              // prints: “а́”

type Output = Ref<QDebug>

The resulting type after applying the << operator.

impl Shl<Ref<QStringRef>> for &QDebug

fn shl(self, t: Ref<QStringRef>) -> Ref<QDebug>

Writes the string, s, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\u1234).

Calls C++ function: QDebug& QDebug::operator<<(const QStringRef& t).

Writes the string, s, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\u1234).

To print non-printable characters without transformation, enable the noquote() functionality. Note that some QDebug backends might not be 8-bit clean.

See the QString overload for examples.

type Output = Ref<QDebug>

The resulting type after applying the << operator.

impl Shl<Ref<QStringView>> for &QDebug

Available on cpp_lib_version="5.11.3" or cpp_lib_version="5.12.2" or cpp_lib_version="5.13.0" or cpp_lib_version="5.14.0" only.

fn shl(self, s: Ref<QStringView>) -> Ref<QDebug>

Writes the string view, s, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\u1234).

Calls C++ function: QDebug& QDebug::operator<<(QStringView s).

Writes the string view, s, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\u1234).

To print non-printable characters without transformation, enable the noquote() functionality. Note that some QDebug backends might not be 8-bit clean.

See the QString overload for examples.

This function was introduced in Qt 5.10.

type Output = Ref<QDebug>

The resulting type after applying the << operator.

impl Shl<Ref<QTextStreamManipulator>> for &QDebug

Calls C++ function: QDebug operator<<(QDebug debug, const QVector<int>& vec).

Warning: no exact match found in C++ documentation. Below is the C++ documentation for QDataStream &operator<<(QDataStream &out, const QBitArray &ba):

Writes bit array ba to stream out.