Back to Qt.io
Contact Us Blog Download Qt

iterator Class

class QLinkedList::iterator

QLinkedList::iterator クラスは、QLinkedList 用の STL スタイルの非 const イテレータを提供します。さらに...

パブリック関数

iterator()
bool operator!=(const QLinkedList<T>::const_iterator &other) const
bool operator!=(const QLinkedList<T>::iterator &other) const
T &operator*() const
QLinkedList<T>::iterator operator+(int j) const
QLinkedList<T>::iterator &operator++()
QLinkedList<T>::iterator operator++(int)
QLinkedList<T>::iterator &operator+=(int j)
QLinkedList<T>::iterator operator-(int j) const
QLinkedList<T>::iterator &operator--()
QLinkedList<T>::iterator operator--(int)
QLinkedList<T>::iterator &operator-=(int j)
T *operator->() const
bool operator==(const QLinkedList<T>::const_iterator &other) const
bool operator==(const QLinkedList<T>::iterator &other) const

詳細説明

QLinkedList には、STLスタイルのイテレータと Javaスタイルのイテレータの両方が用意されている。STLスタイルのイテレータはより低レベルで使い方が面倒ですが、その反面、若干高速で、すでにSTLを知っている開発者にとっては親しみやすいという利点があります。

QLinkedList<T>::iterator では、QLinkedList<T> を反復処理し、イテレータに関連付けられたリスト項目を変更することができます。QLinkedList を反復処理したい場合は、代わりにQLinkedList::const_iterator を使用してください。イテレータを通してQLinkedList を変更する必要がない限り、const でないQLinkedList に対してもQLinkedList::const_iterator を使用するのが一般的です。const イテレータのほうが若干高速で、コードの可読性も向上します。

デフォルトのQLinkedList::iterator コンストラクタは、初期化されていないイテレータを作成します。QLinkedList::begin （）、QLinkedList::end （）、QLinkedList::insert （）のような関数を使用して初期化しなければなりません。以下は、リストに格納されたすべての項目を表示する典型的なループです：

QLinkedList<QString> list;
list.append("January");
list.append("February");
...
list.append("December");

QLinkedList<QString>::iterator i;
for (i = list.begin(); i != list.end(); ++i)
    cout << *i << Qt::endl;

STLスタイルのイテレータは、generic algorithms の引数として使用できます。例えば、リスト内の項目を見つける方法です：

QLinkedList<QString> list;
...
QLinkedList<QString>::iterator it = std::find(list.begin(),
                                              list.end(), "Joel");
if (it != list.end())
    cout << "Found Joel" << Qt::endl;

QLinkedList::iterator QLinkedList::const_iterator 。 <int>に格納されているすべての値を2ずつインクリメントする例です：QLinkedList

QLinkedList<int>::iterator i;
for (i = list.begin(); i != list.end(); ++i)
    *i += 2;

QLinkedList<QString>に格納されているアンダースコア文字で始まる項目をすべて削除する例を示します：

QLinkedList<QString> list;
...
QLinkedList<QString>::iterator i = list.begin();
while (i != list.end()) {
    if ((*i).startsWith('_'))
        i = list.erase(i);
    else
        ++i;
}

QLinkedList::erase() の呼び出しは、イテレータが指す項目をリストから削除し、次の項目へのイテレータを返します。反復処理中に項目を削除するもうひとつの方法を紹介しよう：

QLinkedList<QString>::iterator i = list.begin();
while (i != list.end()) {
    QLinkedList<QString>::iterator previous = i;
    ++i;
    if ((*previous).startsWith('_'))
        list.erase(previous);
}

このようなコードを書きたくなるかもしれない：

// WRONG
while (i != list.end()) {
    if ((*i).startsWith('_'))
        list.erase(i);
    ++i;
}

しかし、これは++i でクラッシュする可能性があります。なぜなら、i は、erase() の呼び出しの後でダングリング・イテレータだからです。

同じリストに複数のイテレータを使用することができます。リストに項目を追加しても、既存のイテレータは有効なままです。リストから項目を削除すると、削除された項目を指すイテレータはダングリング・イテレータになります。

警告 暗黙的に共有されたコンテナ上のイテレータは、STLイテレータのようには動作しません。イテレータがコンテナ上でアクティブになっている間は、コンテナのコピーを避けるべきである。詳細については、暗黙の共有イテレータ問題を参照してください。

QLinkedList::const_iterator およびQMutableLinkedListIteratorも参照して ください。

メンバ関数ドキュメント

bool iterator::operator==(const QLinkedList<T>::const_iterator &other) const

bool iterator::operator==(const QLinkedList<T>::iterator &other) const

other がこのイテレータと同じアイテムを指している場合はtrue を返し、そうでない場合はfalse を返す。

operator!=()も参照の こと。

bool iterator::operator!=(const QLinkedList<T>::const_iterator &other) const

bool iterator::operator!=(const QLinkedList<T>::iterator &other) const

other がこのイテレータと異なる項目を指している場合はtrue を返し、そうでない場合はfalse を返す。

operator==()も参照して ください。

iterator::iterator()

初期化されていないイテレータを構築します。

operator*() や operator++() のような関数を、初期化されていないイテレータに対して呼び出すことはできません。operator=() を使用して値を代入してから使用してください。

QLinkedList::begin() およびQLinkedList::end()も参照してください 。

T &iterator::operator*() const

現在の項目への変更可能な参照を返します。

例えば、代入の左辺で operator*() を使用することで、項目の値を変更できます：

if (*it == "Hello")
    *it = "Bonjour";

operator->()も参照 。

QLinkedList<T>::iterator iterator::operator+(int j) const

このイテレータからj 前方の位置の項目へのイテレータを返します。(j が負の場合、イテレータは後方に進みます）。

j の値が大きい場合、この処理に時間がかかることがあります。

operator-()も参照 。

QLinkedList<T>::iterator &iterator::operator++()

前置 ++ 演算子 (++it) は、イテレータをリストの次の項目に進め、新しい現在の項目へのイテレータを返します。

この関数をQLinkedList::end() で呼び出すと、未定義の結果になります。

operator--()も参照してください 。

QLinkedList<T>::iterator iterator::operator++(int)

これはオーバーロードされた関数です。

postfix ++ 演算子 (it++) は、イテレータをリストの次の項目に進め、それ以前の現在の項目へのイテレータを返します。

QLinkedList<T>::iterator &iterator::operator+=(int j)

イテレータをj アイテム分進めます。(j が負の場合、イテレータは逆方向に進みます)。

operator-=() およびoperator+()も参照 。

QLinkedList<T>::iterator iterator::operator-(int j) const

このイテレータからj 後方の位置にある項目へのイテレータを返します。(j が負の場合、イテレータは前方に進む)。

この操作は、j の値が大きい場合に遅くなることがあります。

operator+()も参照 。

QLinkedList<T>::iterator &iterator::operator--()

前置 - 演算子 (--it) は、直前の項目を現在の項目にし、新しい現在の項目へのイテレータを返します。

この関数をQLinkedList::begin() で呼び出すと、未定義の結果になります。

operator++()も参照してください 。

QLinkedList<T>::iterator iterator::operator--(int)

これはオーバーロードされた関数です。

postfix - 演算子 (it--) は、直前の項目をカレントにし、前にカレントだった項目へのイテレータを返します。

QLinkedList<T>::iterator &iterator::operator-=(int j)

イテレータは、j アイテム分さかのぼります。(j が負の場合、イテレータは前に進みます）。

operator+=() およびoperator-()も参照 。

T *iterator::operator->() const

現在の項目へのポインタを返します。

operator*()も参照 。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 ここで提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。