QCborArray::Iterator Class
class QCborArray::IteratorQCborArray::Iterator クラスは、QCborArray に対してSTLスタイルの非constイテレータを提供します。詳細...
- 継承されたメンバーを含むすべてのメンバーの一覧
- Iteratorは、QtのCBORサポートの一部です。
QCborArray::Iterator の比較
| カテゴリ | 比較可能な型 |
|---|---|
| strong | QCborArray::Iterator |
| strong | QCborArray::ConstIterator. |
パブリック型
パブリック関数
| Iterator() | |
| Iterator(const QCborArray::Iterator &other) | |
| QCborValueRef | operator*() const |
| QCborArray::Iterator | operator+(qsizetype j) const |
| QCborArray::Iterator & | operator++() |
| QCborArray::Iterator | operator++(int) |
| QCborArray::Iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QCborArray::Iterator other) const |
| QCborArray::Iterator | operator-(qsizetype j) const |
| QCborArray::Iterator & | operator--() |
| QCborArray::Iterator | operator--(int) |
| QCborArray::Iterator & | operator-=(qsizetype j) |
| const QCborValueConstRef * | operator->() const |
| QCborArray::Iterator & | operator=(const QCborArray::Iterator &other) |
| QCborValueRef | operator[](qsizetype j) const |
関連する非メンバー
| bool | operator!=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator!=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator<(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator<(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator<=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator<=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator==(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator==(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator>(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator>(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator>=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator>=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
詳細な説明
QCborArray::Iterator QCborArray を反復処理し、イテレータに関連付けられた配列要素を変更することができます。const を反復処理したい場合は、代わりに を使用してください。イテレータを通じて を変更する必要がない限り、非constの に対しても を使用するのが一般的なベストプラクティスです。constイテレータはわずかに高速であり、コードの可読性を向上させます。QCborArray QCborArray::ConstIterator QCborArray QCborArray QCborArray::ConstIterator
イテレータは、QCborArray::begin()、QCborArray::end()、QCborArray::insert() といったQCborArray 関数を使用して初期化されます。初期化が完了して初めて、反復処理が可能になります。
ほとんどのQCborArray 関数は、イテレータではなく整数のインデックスを受け取ります。そのため、QCborArray と組み合わせてイテレータを使用することはほとんどありません。STLスタイルのイテレータが有用となる場面の一つは、generic algorithms の引数として使用する場合です。
同じ配列に対して複数のイテレータを使用することができます。ただし、QCborArray に対して non-const 関数を呼び出すと、既存のすべてのイテレータが未定義の状態になることに注意してください。
QCborArray::ConstIteratorも参照してください 。
メンバ型のドキュメント
Iterator::iterator_category
このイテレータがランダムアクセス・イテレータであることを示す、std::random_access_iterator_tagの同義語。
メンバ関数のドキュメント
[constexpr noexcept default] Iterator::Iterator()
初期化されていないイテレータを生成します。
初期化されていないイテレータに対して、operator*() や operator++() などの関数を呼び出してはなりません。使用する前に、operator=() を使用して値を代入してください。
QCborArray::begin() およびQCborArray::end()も参照してください 。
[constexpr noexcept default] Iterator::Iterator(const QCborArray::Iterator &other)
other のコピーを作成します。
QCborValueRef Iterator::operator*() const
現在の項目への変更可能な参照を返します。
代入文の左辺で演算子*()を使用することで、項の値を変更できます。
戻り値の型はQCborValueRefであり、これはQCborArray およびQCborMap のヘルパークラスです。QCborValueRef型のオブジェクトを取得すると、それをQCborValue への参照であるかのように使用できます。これに代入を行うと、その代入は、参照を取得したQCborArray またはQCborMap 内の要素に対して適用されます。
QCborArray::Iterator Iterator::operator+(qsizetype j) const
このイテレータからj ステップ先にある項目へのイテレータを返します。j が負の値の場合、イテレータは後方へ移動します。
operator-() およびoperator+=()も参照してください 。
QCborArray::Iterator &Iterator::operator++()
プレフィックス++ 演算子(++it )は、イテレータを配列内の次の要素に進め、そのイテレータを返します。
QCborArray::end() に対してこの関数を呼び出すと、未定義の結果となります。
operator--()も参照してください 。
QCborArray::Iterator Iterator::operator++(int)
後置演算子++ (it++ )は、イテレータを配列内の次の要素に進め、直前の要素へのイテレータを返します。
これはオーバーロードされた関数です。
QCborArray::Iterator &Iterator::operator+=(qsizetype j)
イテレータをj の位置分進めます。j が負の値の場合、イテレータは後退します。このイテレータへの参照を返します。
operator-=() およびoperator+()も参照してください 。
qsizetype Iterator::operator-(QCborArray::Iterator other) const
other に対する、このイテレータのオフセットを返します。
QCborArray::Iterator Iterator::operator-(qsizetype j) const
このイテレータからj ステップ分後退した位置にある項目へのイテレータを返します。j が負の値の場合、イテレータは前方へ移動します。
operator+() およびoperator-=()も参照してください 。
QCborArray::Iterator &Iterator::operator--()
プレフィックス演算子-- (--it )は、直前の要素を現在の要素として設定し、このイテレータを返します。
QCborArray::begin() に対してこの関数を呼び出すと、未定義の結果となります。
operator++()も参照してください 。
QCborArray::Iterator Iterator::operator--(int)
後置演算子-- (it-- )は、直前の要素を現在の要素とし、それより前の現在の要素へのイテレータを返します。
これはオーバーロードされた関数です。
QCborArray::Iterator &Iterator::operator-=(qsizetype j)
イテレータをj 位置分戻します。j が負の値の場合、イテレータは前進します。このイテレータへの参照を返します。
operator+=() およびoperator-()も参照してください 。
const QCborValueConstRef *Iterator::operator->() const
現在の項目への変更可能な参照へのポインタを返します。
QCborArray::Iterator &Iterator::operator=(const QCborArray::Iterator &other)
このイテレータをother のコピーにし、このイテレータへの参照を返します。
QCborValueRef Iterator::operator[](qsizetype j) const
このイテレータが指すアイテムから、j ステップ分前方にあるアイテムへの、変更可能な参照を返します。
この関数は、QCborArray イテレータが C++ ポインタのように振る舞うようにするために提供されています。
戻り値の型は QCborValueRef であり、これはQCborArray およびQCborMap のヘルパークラスです。QCborValueRef 型のオブジェクトを取得すると、それをQCborValue への参照であるかのように使用できます。これに代入を行うと、その代入は、参照を取得したQCborArray またはQCborMap 内の要素に適用されます。
operator+()も参照してください 。
関連する非メンバー
[noexcept] bool operator!=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator!=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
lhs がrhs イテレータとは異なる配列のエントリを指している場合はtrue を返し、そうでない場合はfalse を返します。
operator==()も参照してください 。
[noexcept] bool operator<(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator<(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
lhs イテレータが指す配列内の要素が、rhs イテレータが指す要素よりも前に存在する場合、true を返します。
[noexcept] bool operator<=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator<=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
lhs で指される配列のエントリが、rhs で指されるエントリよりも前に存在するか、あるいはそれと同じエントリである場合、true を返します。
[noexcept] bool operator==(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator==(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
lhs がrhs イテレータと同じ配列のエントリを指している場合はtrue を返し、そうでない場合はfalse を返します。
operator!=()も参照してください 。
[noexcept] bool operator>(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator>(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
lhs で指し示される配列内の要素が、rhs で指し示される要素よりも後に存在する場合、true を返します。
[noexcept] bool operator>=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator>=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
lhs で指される配列内の要素が、rhs で指される要素の後に存在するか、あるいはそれと同じ要素である場合、true を返します。
© 2026 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.