iterator Class

(QTextBlock::iterator)

The QTextBlock::iterator class provides an iterator for reading the contents of a QTextBlock. More...

Header: #include <iterator>
qmake: QT += gui

Public Functions

iterator()
iterator(const iterator &other)
bool atEnd() const
QTextFragment fragment() const
bool operator!=(const iterator &other) const
iterator & operator++()
iterator operator++(int)
iterator & operator--()
iterator operator--(int)
bool operator==(const iterator &other) const

Detailed Description

The QTextBlock::iterator class provides an iterator for reading the contents of a QTextBlock.

A block consists of a sequence of text fragments. This class provides a way to iterate over these, and read their contents. It does not provide a way to modify the internal structure or contents of the block.

An iterator can be constructed and used to access the fragments within a text block in the following way:

    QTextBlock::iterator it;
    for (it = currentBlock.begin(); !(it.atEnd()); ++it) {
        QTextFragment currentFragment = it.fragment();
        if (currentFragment.isValid())
            processFragment(currentFragment);
    }

See also QTextFragment.

Member Function Documentation

iterator::iterator()

Constructs an iterator for this text block.

iterator::iterator(const iterator &other)

Copy constructor. Constructs a copy of the other iterator.

bool iterator::atEnd() const

Returns true if the current item is the last item in the text block.

QTextFragment iterator::fragment() const

Returns the text fragment the iterator currently points to.

bool iterator::operator!=(const iterator &other) const

Retuns true if this iterator is different from the other iterator; otherwise returns false.

iterator &iterator::operator++()

The prefix ++ operator (++i) advances the iterator to the next item in the hash and returns an iterator to the new current item.

iterator iterator::operator++(int)

The postfix ++ operator (i++) advances the iterator to the next item in the text block and returns an iterator to the old current item.

iterator &iterator::operator--()

The prefix -- operator (--i) makes the preceding item current and returns an iterator pointing to the new current item.

iterator iterator::operator--(int)

The postfix -- operator (i--) makes the preceding item current and returns an iterator to the old current item.

bool iterator::operator==(const iterator &other) const

Retuns true if this iterator is the same as the other iterator; otherwise returns false.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qtextblock-iterator.html