Rustでは、標準コレクションライブラリはすべてイテレータの概念に基づいています。イテレータはIteratorトレイトを実装するオブジェクトで、next()メソッドが定義されています。このメソッドはデータシーケンスの次の要素を返します(Option<T>、ここでSome(T)は次の値、Noneはシーケンスの終わり)。
標準イテレータの例:
let v = vec![1, 2, 3]; let mut iter = v.iter(); while let Some(x) = iter.next() { println!("{}", x); }
イテレータアダプタとは、(例えば.map()、.filter()、.enumerate()、.take()など)新しいイテレータを返すメソッドで、渡された関数に従って「その場で」値を処理します。
カスタムイテレータは、構造体を作成し、特定の動作を持つIteratorトレイトを実装することで生成されます:
struct Counter { count: u8 } impl Iterator for Counter { type Item = u8; fn next(&mut self) -> Option<Self::Item> { if self.count < 5 { self.count += 1; Some(self.count) } else { None } } }
標準アダプタだけでコレクションを処理できる場合はそれを使用してください。独自のイテレータを実装する必要があるのは次のような状況です:
無限イテレータを作成できますか?例えば、
.collect()を使ってコレクションに集めようとした場合、何が起こりますか?
回答: はい、Rustにはstd::iter::repeatのように無限シーケンスを返すイテレータが存在します:
let mut endless = std::iter::repeat(1); endless.next(); // Some(1)を無限に返します
このようなイテレータを.collect()でコレクションに集めようとすると、プログラムはハングするか、メモリのオーバーフローによりクラッシュします。なぜなら、イテレーションは自動的に終了しないからです!
逸話
REST APIプロジェクトでは、1000の要素の配列をソートしてから、.iter().filter(|x| *x > 500)を使用しましたが、.collect::<Vec<_>>()の代わりに複雑なアダプタ内で.fold(0, |acc, _| acc + 1)を使用し、イテレーションが正しく終了するかどうかの理解を失いました。その結果、内蔵エラーのある制限のない遅延イテレータによるフィルタリングのためにランダムにハングしました。
逸話
ある独自のID生成エンジンで、ある開発者がカスタムイテレータを実装し、リミットに達した際にNoneを返すのを忘れました。その結果、イテレーションは無限ループに陥り、プロダクションサーバーがCPUを使いつくし、リクエストに応答しなくなりました。
逸話
フロントエンド部分(WebAssemblyモジュール)では、入れ子のアダプタを使用したイテレータを.map().filter().skip()で使用し、形状のために.collect()を通じて結果を取得しようとしました。アダプタの下でタイプを変更した際に、Rustは型の不一致に関する複雑なコンパイル時エラーを示しました。これは、コレクションの正確な型を指定するのを忘れたためでした: .collect::<Vec<_>>()。この問題はアノテーションを追加することで解決しましたが、原因を探すのに数時間を費やしました。