iterator Class
class QTextBlock::iteratorThe 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
.