qdebug.cpp

stream->context.version > 1	Description
TRUE	evaluated 921 times by 12 tests Evaluated by: tst_QDebug tst_QGuiVariant tst_QLocalSocket tst_QMetaObject tst_QNetworkConfigurationManager tst_QNetworkProxyFactory tst_QNetworkReply tst_QSslSocket tst_QTcpServer tst_QTcpSocket tst_QUdpSocket tst_QWidget
FALSE	never evaluated

0-921

358

stream->flags = 0;

executed 921 times by 12 tests: stream->flags = 0;

Executed by:

tst_QDebug
tst_QGuiVariant
tst_QLocalSocket
tst_QMetaObject
tst_QNetworkConfigurationManager
tst_QNetworkProxyFactory
tst_QNetworkReply
tst_QSslSocket
tst_QTcpServer
tst_QTcpSocket
tst_QUdpSocket
tst_QWidget

921

359

stream->setVerbosity(Stream::defaultVerbosityDefaultVerbosity);

360

return *this;

executed 921 times by 12 tests: return *this;

Executed by:

tst_QDebug
tst_QGuiVariant
tst_QLocalSocket
tst_QMetaObject
tst_QNetworkConfigurationManager
tst_QNetworkProxyFactory
tst_QNetworkReply
tst_QSslSocket
tst_QTcpServer
tst_QTcpSocket
tst_QUdpSocket
tst_QWidget

921

}

/*!

\fn QDebug &QDebug::space()

365

366

Writes a space character to the debug stream and returns a reference to

367

the stream.

368

369

The stream remembers that automatic insertion of spaces is

370

enabled for future writes.

371

372

\sa nospace(), maybeSpace()

/*!

\fn QDebug &QDebug::nospace()

377

378

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

379

380

\sa space(), maybeSpace()

/*!

\fn QDebug &QDebug::maybeSpace()

385

386

Writes a space character to the debug stream, depending on the current

387

setting for automatic insertion of spaces, and returns a reference to the stream.

388

389

\sa space(), nospace()

/*!

\fn bool QDebug::autoInsertSpaces() const

394

395

Returns \c true if this QDebug instance will automatically insert spaces

between writes.

\since 5.0

\sa QDebugStateSaver

/*!

\fn void QDebug::setAutoInsertSpaces(bool b)

405

406

Enables automatic insertion of spaces between writes if \a b is true; otherwise

407

automatic insertion of spaces is disabled.

\since 5.0

\sa QDebugStateSaver

/*!

\fn QDebug &QDebug::quote()

417

\since 5.4

418

419

Enables automatic insertion of quotation characters around QChar, QString and QByteArray

420

contents and returns a reference to the stream.

421

422

Quoting is enabled by default.

423

424

\sa noquote(), maybeQuote()

/*!

\fn QDebug &QDebug::noquote()

429

\since 5.4

430

431

Disables automatic insertion of quotation characters around QChar, QString and QByteArray

432

contents and returns a reference to the stream.

433

434

When quoting is disabled, these types are printed without quotation

435

characters and without escaping of non-printable characters.

436

437

\sa quote(), maybeQuote()

/*!

\fn QDebug &QDebug::maybeQuote(char c)

442

\since 5.4

443

444

Writes a character \a c to the debug stream, depending on the

445

current setting for automatic insertion of quotes, and returns a reference to the stream.

446

447

The default character is a double quote \c{"}.

448

449

\sa quote(), noquote()

/*!

\fn int QDebug::verbosity() const

454

\since 5.6

455

456

Returns the verbosity of the debug stream.

457

458

Streaming operators can check the value to decide whether

459

verbose output is desired and print more information depending on the

460

level. Higher values indicate that more information is desired.

461

462

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

\sa setVerbosity()

/*!

\fn void QDebug::setVerbosity(int verbosityLevel)

469

\since 5.6

470

471

Sets the verbosity of the stream to \a verbosityLevel.

472

473

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

\sa verbosity()

/*!

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

480

481

Writes the character, \a t, to the stream and returns a reference to the

482

stream. Normally, QDebug prints control characters and non-US-ASCII

483

characters as their C escape sequences or their Unicode value (\\u1234). To

484

print non-printable characters without transformation, enable the noquote()

485

functionality, but note that some QDebug backends may not be 8-bit clean

486

and may not be able to represent \c t.

/*!

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

491

492

Writes the boolean value, \a t, to the stream and returns a reference to the

stream.

/*!

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

498

499

Writes the character, \a t, to the stream and returns a reference to the

stream.

/*!

\fn QDebug &QDebug::operator<<(signed short i)

505

506

Writes the signed short integer, \a i, to the stream and returns a reference

to the stream.

/*!

\fn QDebug &QDebug::operator<<(unsigned short i)

512

513

Writes then unsigned short integer, \a i, to the stream and returns a

514

reference to the stream.

/*!

\fn QDebug &QDebug::operator<<(signed int i)

519

520

Writes the signed integer, \a i, to the stream and returns a reference

to the stream.

/*!

\fn QDebug &QDebug::operator<<(unsigned int i)

526

527

Writes then unsigned integer, \a i, to the stream and returns a reference to

the stream.

/*!

\fn QDebug &QDebug::operator<<(signed long l)

533

534

Writes the signed long integer, \a l, to the stream and returns a reference

to the stream.

/*!

\fn QDebug &QDebug::operator<<(unsigned long l)

540

541

Writes then unsigned long integer, \a l, to the stream and returns a reference

to the stream.

/*!

\fn QDebug &QDebug::operator<<(qint64 i)

547

548

Writes the signed 64-bit integer, \a i, to the stream and returns a reference

to the stream.

/*!

\fn QDebug &QDebug::operator<<(quint64 i)

554

555

Writes then unsigned 64-bit integer, \a i, to the stream and returns a

556

reference to the stream.

/*!

\fn QDebug &QDebug::operator<<(float f)

561

562

Writes the 32-bit floating point number, \a f, to the stream and returns a

563

reference to the stream.

/*!

\fn QDebug &QDebug::operator<<(double f)

568

569

Writes the 64-bit floating point number, \a f, to the stream and returns a

570

reference to the stream.

/*!

\fn QDebug &QDebug::operator<<(const char *s)

575

576

Writes the '\\0'-terminated string, \a s, to the stream and returns a

577

reference to the stream. The string is never quoted nor transformed to the

578

output, but note that some QDebug backends might not be 8-bit clean.

/*!

\fn QDebug &QDebug::operator<<(const QString &s)

583

584

Writes the string, \a s, to the stream and returns a reference to the

585

stream. Normally, QDebug prints the string inside quotes and transforms

586

non-printable characters to their Unicode values (\\u1234).

587

588

To print non-printable characters without transformation, enable the

589

noquote() functionality. Note that some QDebug backends might not be 8-bit

clean.

Output examples:

\code

QString s;

s = "a";

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

598

qDebug() << s; // prints: "a"

599

600

s = "\"a\r\n\"";

601

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

602

603

s = "\033"; // escape character

604

qDebug() << s; // prints: "\u001B"

605

606

s = "\u00AD"; // SOFT HYPHEN

607

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

608

609

s = "\u00E1"; // LATIN SMALL LETTER A WITH ACUTE

610

qDebug() << s; // prints: "á"

611

612

s = "a\u0301"; // "a" followed by COMBINING ACUTE ACCENT

613

qDebug() << s; // prints: "á";

614

615

s = "\u0430\u0301"; // CYRILLIC SMALL LETTER A followed by COMBINING ACUTE ACCENT

616

qDebug() << s; // prints: "а́"

\endcode

/*!

\fn QDebug &QDebug::operator<<(const QStringRef &s)

622

623

Writes the string, \a s, to the stream and returns a reference to the

624

stream. Normally, QDebug prints the string inside quotes and transforms

625

non-printable characters to their Unicode values (\\u1234).

626

627

To print non-printable characters without transformation, enable the

628

noquote() functionality. Note that some QDebug backends might not be 8-bit

629

clean.

630

631

See the QString overload for examples.

/*!

\fn QDebug &QDebug::operator<<(QLatin1String s)

636

637

Writes the string, \a s, to the stream and returns a reference to the

638

stream. Normally, QDebug prints the string inside quotes and transforms

639

non-printable characters to their Unicode values (\\u1234).

640

641

To print non-printable characters without transformation, enable the

642

noquote() functionality. Note that some QDebug backends might not be 8-bit

643

clean.

644

645

See the QString overload for examples.

/*!

\fn QDebug &QDebug::operator<<(const QByteArray &b)

650

651

Writes the byte array, \a b, to the stream and returns a reference to the

652

stream. Normally, QDebug prints the array inside quotes and transforms

653

control or non-US-ASCII characters to their C escape sequences (\\xAB). This

654

way, the output is always 7-bit clean and the string can be copied from the

655

output and pasted back into C++ sources, if necessary.

656

657

To print non-printable characters without transformation, enable the

658

noquote() functionality. Note that some QDebug backends might not be 8-bit

clean.

Output examples:

\code

QByteArray ba;

ba = "a";

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

667

qDebug() << ba; // prints: "a"

668

669

ba = "\"a\r\n\"";

670

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

671

672

ba = "\033"; // escape character

673

qDebug() << ba; // prints: "\x1B"

674

675

ba = "\xC3\xA1";

676

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

677

678

ba = QByteArray("a\0b", 3);

679

qDebug() << ba // prints: "\a\x00""b"

680

\endcode

681

682

Note how QDebug needed to close and reopen the string in the way C and C++

683

languages concatenate string literals so that the letter 'b' is not

684

interpreted as part of the previous hexadecimal escape sequence.

/*!

\fn QDebug &QDebug::operator<<(const void *p)

689

690

Writes a pointer, \a p, to the stream and returns a reference to the stream.

/*!

\fn QDebug &QDebug::operator<<(QTextStreamFunction f)

\internal

/*!

\fn QDebug &QDebug::operator<<(QTextStreamManipulator m)

\internal

/*!

\fn QDebug operator<<(QDebug stream, const QList<T> &list)

705

\relates QDebug

706

707

Writes the contents of \a list to \a stream. \c T needs to

708

support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const std::list<T, Alloc> &list)

\relates QDebug

\since 5.7

Writes the contents of \a list to \a stream. \c T needs to

717

support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const QVector<T> &vector)

722

\relates QDebug

723

724

Writes the contents of \a vector to \a stream. \c T needs to

725

support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const std::vector<T, Alloc> &vector)

\relates QDebug

\since 5.7

Writes the contents of \a vector to \a stream. \c T needs to

734

support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const QSet<T> &set)

739

\relates QDebug

740

741

Writes the contents of \a set to \a stream. \c T needs to

742

support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const QMap<Key, T> &map)

747

\relates QDebug

748

749

Writes the contents of \a map to \a stream. Both \c Key and

750

\c T need to support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const std::map<Key, T, Compare, Alloc> &map)

\relates QDebug

\since 5.7

Writes the contents of \a map to \a stream. Both \c Key and

759

\c T need to support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const std::multimap<Key, T, Compare, Alloc> &map)

\relates QDebug

\since 5.7

Writes the contents of \a map to \a stream. Both \c Key and

768

\c T need to support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const QHash<Key, T> &hash)

773

\relates QDebug

774

775

Writes the contents of \a hash to \a stream. Both \c Key and

776

\c T need to support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const QPair<T1, T2> &pair)

781

\relates QDebug

782

783

Writes the contents of \a pair to \a stream. Both \c T1 and

784

\c T2 need to support streaming into QDebug.

/*!

\fn QDebug operator<<(QDebug stream, const QFlags<T> &flag)

\relates QDebug

\since 4.7

Writes \a flag to \a stream.

/*!

\fn QDebug operator<<(QDebug debug, const QSharedPointer<T> &ptr)

797

\relates QSharedPointer

798

\since 5.7

799

800

Writes the pointer tracked by \a ptr into the debug object \a debug for

801

debugging purposes.

802

803

\sa {Debugging Techniques}

/*!

\class QDebugStateSaver

808

\inmodule QtCore

809

\brief Convenience class for custom QDebug operators

810

811

Saves the settings used by QDebug, and restores them upon destruction,

812

then calls \l {QDebug::maybeSpace()}{maybeSpace()}, to separate arguments with a space if

813

\l {QDebug::autoInsertSpaces()}{autoInsertSpaces()} was true at the time of constructing the QDebugStateSaver.

814

815

The automatic insertion of spaces between writes is one of the settings

816

that QDebugStateSaver stores for the duration of the current block.

817

818

The settings of the internal QTextStream are also saved and restored,

819

so that using << hex in a QDebug operator doesn't affect other QDebug

operators.

\since 5.1

class QDebugStateSaverPrivate

826

{

827

public:

828

QDebugStateSaverPrivate(QDebug &dbg)

829

: m_dbg(dbg),

830

m_spaces(dbg.autoInsertSpaces()),

831

m_flags(0),

832

m_streamParams(dbg.stream->ts.d_ptr->params)

833

{

834

if (m_dbg.stream->context.version > 1)

835

m_flags = m_dbg.stream->flags;

}

void restoreState()

{

const bool currentSpaces = m_dbg.autoInsertSpaces();

840

if (currentSpaces && !m_spaces)

841

if (m_dbg.stream->buffer.endsWith(QLatin1Char(' ')))

842

m_dbg.stream->buffer.chop(1);

843

844

m_dbg.setAutoInsertSpaces(m_spaces);

845

m_dbg.stream->ts.d_ptr->params = m_streamParams;

846

if (m_dbg.stream->context.version > 1)

847

m_dbg.stream->flags = m_flags;

848

849

if (!currentSpaces && m_spaces)

850

m_dbg.stream->ts << ' ';

}

QDebug &m_dbg;

// QDebug state

const bool m_spaces;

int m_flags;

// QTextStream state

const QTextStreamPrivate::Params m_streamParams;

};

/*!

Creates a QDebugStateSaver instance, which saves the settings

866

currently used by \a dbg.

867

868

\sa QDebug::setAutoInsertSpaces(), QDebug::autoInsertSpaces()

869

870

QDebugStateSaver::QDebugStateSaver(QDebug &dbg)

871

: d(new QDebugStateSaverPrivate(dbg))

{

}

/*!

Destroys a QDebugStateSaver instance, which restores the settings

877

used when the QDebugStateSaver instance was created.

878

879

\sa QDebug::setAutoInsertSpaces(), QDebug::autoInsertSpaces()

880

881

QDebugStateSaver::~QDebugStateSaver()

{

d->restoreState();

}

/*!

\internal

Specialization of the primary template in qdebug.h to out-of-line

890

the common case of QFlags<T>::Int being int.

891

892

Just call the generic version so the two don't get out of sync.

893

894

void qt_QMetaEnum_flagDebugOperator(QDebug &debug, size_t sizeofT, int value)

895

{

896

qt_QMetaEnum_flagDebugOperator<int>(debug, sizeofT, value);

897

}

executed 13 times by 2 tests: end of block

Executed by:

tst_QDebug
tst_QNetworkConfigurationManager

898

899

#ifndef QT_NO_QOBJECT

/*!

\internal

QDebug qt_QMetaEnum_debugOperator(QDebug &dbg, int value, const QMetaObject *meta, const char *name)

904

{

905

QDebugStateSaver saver(dbg);

906

QMetaEnum me = meta->enumerator(meta->indexOfEnumerator(name));

907

const char *key = me.valueToKey(value);

908

dbg.nospace() << meta->className() << "::" << name << '(';

if (key)

dbg << key;

else

dbg << value;

dbg << ')';

return dbg;

}

QDebug qt_QMetaEnum_flagDebugOperator(QDebug &debug, quint64 value, const QMetaObject *meta, const char *name)

918

{

919

QDebugStateSaver saver(debug);

debug.resetFormat();

debug.noquote();

debug.nospace();

debug << "QFlags<";

const QMetaEnum me = meta->enumerator(meta->indexOfEnumerator(name));

925

if (const char *scope = me.scope())

926

debug << scope << "::";

927

debug << me.name() << ">(" << me.valueToKeys(value) << ')';

928

return debug;

929

}

930

#endif // !QT_NO_QOBJECT

931

932

QT_END_NAMESPACE

Generated by Squish Coco Non-Commercial 4.3.0-BETA-master-30-08-2018-4cb69e9