QTextBlock::iterator Class

class QTextBlock::iterator

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

List of all members, including inherited members
iterator is part of Rich Text Processing APIs.

Public Functions

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

Detailed Description

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

`[constexpr noexcept]` iterator::iterator()

Constructs an iterator for this text block.

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 QTextBlock::iterator &other) const

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

QTextBlock::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.

QTextBlock::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.

QTextBlock::iterator &iterator::operator--()

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

QTextBlock::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 QTextBlock::iterator &other) const

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

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.