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
.
© 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.