Effect-TS は、オプションに特定の値が含まれているかどうかを確認するメソッドを提供します。これらの関数を使用すると、カスタム等価関数またはデフォルトの等価関数を使用して、オプション内の値の存在を判断できます。この記事では、オプションの要素をチェックするための 2 つの主要な関数、O.containsWith と O.contains.

例 1: O.containsWith を使用したカスタム等価性を持つ要素のチェック

コンセプト

O.containsWith 関数は、カスタム等価関数を使用して、オプションに指定された値が含まれているかどうかを確認します。この関数は、オプションに指定された等価性に従って値が含まれている場合に true を返します。それ以外の場合は false を返します。

コード

function elements_ex01() {
  const numberEquivalence = Eq.number;

  const some1 = O.some(1); // Create an Option containing the value 1
  const none = O.none(); // Create an Option representing no value

  console.log(pipe(some1, O.containsWith(numberEquivalence)(1))); // Output: true (Option contains 1)
  console.log(pipe(some1, O.containsWith(numberEquivalence)(2))); // Output: false (Option does not contain 2)
  console.log(pipe(none, O.containsWith(numberEquivalence)(1))); // Output: false (Option is None)
}

説明

• pipe(some1, O.containsWith(numberEquivalence)(1)): オプションには値 1 が含まれており、カスタム等価関数によってこれが確認され、結果は true になります。
• pipe(some1, O.containsWith(numberEquivalence)(2)): オプションには値 2 が含まれていないため、結果は false になります。
• pipe(none, O.containsWith(numberEquivalence)(1)): オプションは None なので、チェックされた値に関係なく結果は false になります。

この関数は、カスタム比較ロジックを使用してオプションに特定の値が含まれているかどうかを確認する必要がある場合に便利で、等価性の判断をより柔軟に行うことができます。

例 2: O.contains を使用したデフォルトの等価性を持つ要素のチェック

コンセプト

O.contains 関数は、デフォルトの等価性を使用して、オプションに指定された値が含まれているかどうかを確認します。 Option に値が含まれている場合は true を返します。それ以外の場合は false を返します。この関数は、カスタム比較ロジックが必要ない場合に使用する方が簡単です。

コード

function elements_ex02() {
  const some1 = O.some(1); // Create an Option containing the value 1
  const none = O.none(); // Create an Option representing no value

  console.log(pipe(some1, O.contains(1))); // Output: true (Option contains 1)
  console.log(pipe(some1, O.contains(2))); // Output: false (Option does not contain 2)
  console.log(pipe(none, O.contains(1))); // Output: false (Option is None)
}

説明

• pipe(some1, O.contains(1)): オプションには値 1 が含まれているため、結果は true になります。
• pipe(some1, O.contains(2)): オプションには値 2 が含まれていないため、結果は false になります。
• pipe(none, O.contains(1)): オプションは None なので、チェックされた値に関係なく結果は false になります。

この関数は、デフォルトの等価性で十分な場合に、オプションに特定の値が含まれているかどうかをすばやく確認するのに役立ち、簡単で使いやすくなります。

結論

Effect-TS は、オプションに特定の値が含まれているかどうかを確認する効率的な方法を提供します。 O.containsWith を使用すると、カスタム等価関数を使用して比較の方法を定義できるため、複雑なシナリオに柔軟に対応できます。一方、O.contains は、デフォルトの等価性を利用して単純なチェックを行う、より単純なアプローチを提供します。これらの関数を使用すると、オプションを効果的に処理できるようになり、直感的かつ制御された方法で値の存在を確認できるようになります。