イテレーターは、オブジェクトのリストをカプセル化します。 アプリケーションは、イテレーターを使用して、各オブジェクトに順番にアクセスします。
イテレーターは、リスト内の現在位置を保持するカーソルもカプセル化します。イテレーターの作成時には、カーソルの位置は最初のオブジェクトの前です。
アプリケーションは、イテレーターを直接作成することはできません。イテレーターは、オブジェクトのリストをアプリケーションに戻すために、特定の関数によってのみ作成されます。
これはヘルパー・クラスです。
関数 | 説明 |
---|---|
xmsIteratorDispose | イテレーターを削除します。 |
xmsIteratorGetNext | カーソルを次のオブジェクトに移動し、カーソルの新規の位置にあるオブジェクトを取得します。 |
xmsIteratorHasNext | カーソルの現在位置よりも後にさらにオブジェクトがあるかどうかを検査します。 |
xmsIteratorReset | カーソルを、最初のオブジェクトの前の位置に戻します。 |
xmsRC xmsIteratorDispose(xmsHIterator *iterator, xmsHErrorBlock errorBlock);
アプリケーションが、既に削除されているイテレーターを削除しようとした場合、呼び出しは無視されます。
xmsRC xmsIteratorHasNext(xmsHIterator iterator, xmsBOOL *moreProperties, xmsHErrorBlock errorBlock);
カーソルの現在位置よりも後にさらにオブジェクトがあるかどうかを検査します。この呼び出しによって、カーソルは移動しません。