Rust のイテレータの any 関数を探る

はじめに

この実験では、Iterator::any 関数について説明します。この関数は、イテレータを入力として受け取り、イテレータ内のどれかの要素が与えられた述語を満たす場合に true を返し、それ以外の場合は false を返します。この関数は、Rust の標準ライブラリにおいてトレイトメソッドとして定義されており、Iterator トレイトを実装する任意の型で使用できます。この関数はクロージャを引数として取り、イテレータ内の各要素に適用する述語を決定します。クロージャは FnMut トレイトで定義されており、キャプチャされた変数を変更することはできますが、消費することはできません。any 関数は、イテレータ内のどれかの要素が述語を満たしているかどうかを示すブール値を返します。

注： 実験でファイル名が指定されていない場合、好きなファイル名を使用できます。たとえば、main.rs を使用して、rustc main.rs &&./main でコンパイルして実行することができます。

Iterator::any

Iterator::any は、イテレータを渡された場合、どれかの要素が述語を満たす場合に true を返す関数です。それ以外の場合は false を返します。そのシグネチャは以下の通りです。

pub trait Iterator {
    // 反復処理される型。
    type Item;

    // `any` は `&mut self` を取り、呼び出し元が借用されて変更される可能性があることを意味しますが、消費されません。
    fn any<F>(&mut self, f: F) -> bool where
        // `FnMut` は、キャプチャされた変数が最大で変更される可能性があることを意味しますが、消費されません。`Self::Item` は、クロージャに引数を値で渡すことを示します。
        F: FnMut(Self::Item) -> bool;
}

fn main() {
    let vec1 = vec![1, 2, 3];
    let vec2 = vec![4, 5, 6];

    // Vec の `iter()` は `&i32` を生成します。`i32` に分解します。
    println!("2 in vec1: {}", vec1.iter()    .any(|&x| x == 2));
    // Vec の `into_iter()` は `i32` を生成します。分解は不要です。
    println!("2 in vec2: {}", vec2.into_iter().any(|x| x == 2));

    // `iter()` は `vec1` とその要素を借用するだけなので、再利用できます。
    println!("vec1 len: {}", vec1.len());
    println!("First element of vec1 is: {}", vec1[0]);
    // `into_iter()` は `vec2` とその要素を移動させるので、再利用できません。
    // println!("First element of vec2 is: {}", vec2[0]);
    // println!("vec2 len: {}", vec2.len());
    // TODO: 上の 2 行をコメントアウト解除してコンパイラエラーを確認してください。

    let array1 = [1, 2, 3];
    let array2 = [4, 5, 6];

    // 配列の `iter()` は `&i32` を生成します。
    println!("2 in array1: {}", array1.iter()    .any(|&x| x == 2));
    // 配列の `into_iter()` は `i32` を生成します。
    println!("2 in array2: {}", array2.into_iter().any(|x| x == 2));
}

まとめ

おめでとうございます！あなたは Iterator::any の実験を完了しました。あなたのスキルを向上させるために、LabEx でさらに多くの実験を行って練習してください。