Java Vector containsAll() メソッド
containsAll()メソッドは Java のVectorVector クラスが提供するコレクション操作方法で、現在の Vector がVector指定されたコレクション内のすべての要素を含むかどうか。これはCollectionCollection インターフェースから継承されたメソッドで、VectorVector クラス内で実装されています。
構文
public boolean containsAll(Collection<?> c)
メソッドパラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
| c | Collection<?> | 現在の Vector に含まれているかどうかをチェックする要素のコレクション |
戻り値
このメソッドはブール値を返します:
true:現在の Vector が指定されたコレクション内のすべての要素を含む場合false:現在の Vector が指定されたコレクション内のすべての要素を含まない場合
メソッドの特性
- 完全包含チェック:Vector がコレクション内のすべての要素を含む場合にのみ true を返します
- 空のコレクションの処理:渡されたコレクションが空の場合、メソッドは true を返します
- 要素の順序は無関係:要素がコレクション内でどのような順序であるかは気にしません
- 重複要素の処理:要素の重複回数を考慮します
使用例
例1:基本的な使い方
例
import java.util.Vector;
import java.util.Arrays;
public class VectorContainsAllExample {
public static void main(String[] args) {
// Vector を作成する
Vector<String> vector = new Vector<>();
vector.add("Apple");
vector.add("Banana");
vector.add("Orange");
vector.add("Grape");
// チェック対象のコレクションを作成する
List<String> checkList = Arrays.asList("Apple", "Banana");
// containsAll() メソッドを使用する
boolean result = vector.containsAll(checkList);
System.out.println("Vector は指定されたすべての要素を含んでいますか? " + result); // 出力: true
}
}
import java.util.Arrays;
public class VectorContainsAllExample {
public static void main(String[] args) {
// Vector を作成する
Vector<String> vector = new Vector<>();
vector.add("Apple");
vector.add("Banana");
vector.add("Orange");
vector.add("Grape");
// チェック対象のコレクションを作成する
List<String> checkList = Arrays.asList("Apple", "Banana");
// containsAll() メソッドを使用する
boolean result = vector.containsAll(checkList);
System.out.println("Vector は指定されたすべての要素を含んでいますか? " + result); // 出力: true
}
}
例2:一部が含まれない場合
例
Vector<Integer> numbers = new Vector<>(Arrays.asList(1, 2, 3, 4, 5));
List<Integer> checkNumbers = Arrays.asList(2, 6);
boolean result = numbers.containsAll(checkNumbers);
System.out.println(result); // 出力: false。6 が Vector に含まれていないため
List<Integer> checkNumbers = Arrays.asList(2, 6);
boolean result = numbers.containsAll(checkNumbers);
System.out.println(result); // 出力: false。6 が Vector に含まれていないため
例3:空集合の場合
例
Vector<String> fruits = new Vector<>(Arrays.asList("Apple", "Banana"));
List<String> emptyList = new ArrayList<>();
boolean result = fruits.containsAll(emptyList);
System.out.println(result); // 出力: true。任意のコレクションは空のコレクションを含むため
List<String> emptyList = new ArrayList<>();
boolean result = fruits.containsAll(emptyList);
System.out.println(result); // 出力: true。任意のコレクションは空のコレクションを含むため
注意事項
- パフォーマンスの考慮事項:大きなコレクションの場合、このメソッドは O(n) の時間計算量が必要になる場合があります
- null の処理:
- 渡されたコレクションパラメータが null の場合、NullPointerException がスローされます
- Vector は null 要素を含むことができ、チェック時には null 要素も考慮されます
- 等価性の判定:要素の equals() メソッドを使用して包含を判定します
関連メソッドとの比較
| メソッド | 説明 | containsAll() との違い |
|---|---|---|
| contains() | 単一の要素が存在するかどうかをチェックする | コレクションではなく1つの要素のみをチェックする |
| retainAll() | 指定されたコレクション内の要素を保持する | 元のコレクションを変更する |
| removeAll() | 指定されたコレクション内の要素を削除する | 元のコレクションを変更する |
実際の応用シーン
- 権限チェック:ユーザーが必要なすべての権限を持っているかどうかを検証する
- ショッピングカート機能:在庫がショッピングカート内のすべての商品を含むかどうかをチェックする
- コース履修:学生がすべての必修コースを修了したかどうかを検証する
例
// 実際の応用例:権限チェック
Vector<String> userPermissions = getUserPermissions();
Vector<String> requiredPermissions = getRequiredPermissions();
if (!userPermissions.containsAll(requiredPermissions)) {
throw new SecurityException("ユーザーには必要な権限がありません");
}
Vector<String> userPermissions = getUserPermissions();
Vector<String> requiredPermissions = getRequiredPermissions();
if (!userPermissions.containsAll(requiredPermissions)) {
throw new SecurityException("ユーザーには必要な権限がありません");
}
よくある質問(FAQ)
Q1: containsAll() メソッドは元の Vector を変更しますか?
A: いいえ、containsAll() は単なるクエリメソッドであり、元の Vector は変更されません。
Q2: Vector に重複要素がある場合、containsAll() はどのように動作しますか?
A: containsAll() は要素が存在するかどうかのみを気にし、出現回数は気にしません。各要素が少なくとも1回出現すれば true を返します。
Q3: 異なる型のコレクションをチェックできますか?
A: はい、できます。要素の型が互換性があれば(equals() メソッドで比較できれば)可能です。
まとめ
Vector.containsAll()このメソッドは実用的なコレクション操作ツールであり、あるコレクションが別のコレクションのサブセットであるかを簡単にチェックできます。このメソッドを理解して正しく使用することで、開発者はより簡潔で効率的なコレクション操作コードを書くことができます。
Java Vector