- Qt 6.6
- Qt GUI
- C++ Classes
- iterator
- Qt 6.6.0 Reference Documentation

# 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 iterator &other) const
iterator & | operator++()
iterator | operator++(int)
iterator & | operator--()
iterator | operator--(int)
bool | operator==(const 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 iterator &other) const

Returns 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

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