C# List.Contains(T) メソッド

このサイトはプロモーションを含みます

2024年9月8日

C#でプログラミングをしていると、リスト内に特定の要素が存在するかどうかを確認したい場面がよくあります。例えば、ユーザーIDのリストに特定のIDが含まれているかチェックしたり、許可されたキーワードのリストに入力された単語が存在するか確認したりする際に使用します。そんな時に便利なのが List<T>.Contains(T) メソッドです。この記事では、C#の List<T>.Contains(T) メソッドの使い方と活用例について、初心者の方にも分かりやすく解説します。

List<T>.Contains(T) メソッドの基本

List<T>.Contains(T) メソッドは、リスト内に指定した要素が存在するかどうかを判定します。このメソッドは bool 型（真偽値）を返し、要素が見つかった場合は true、見つからなかった場合は false を返します。

基本的な使い方は次のとおりです：

using System;
using System.Collections.Generic;

class ListContainsExample
{
    static void Main()
    {
        List<string> fruits = new List<string> { "りんご", "バナナ", "オレンジ", "いちご" };

        bool containsApple = fruits.Contains("りんご");
        bool containsMelon = fruits.Contains("メロン");

        Console.WriteLine($"リストに「りんご」が含まれているか: {containsApple}");
        Console.WriteLine($"リストに「メロン」が含まれているか: {containsMelon}");
    }
}

このコードを実行すると、以下のような出力が得られます：

リストに「りんго」が含まれているか: True
リストに「メロン」が含まれているか: False

List<T>.Contains(T) メソッドの活用例

List<T>.Contains(T) メソッドは、様々な場面で活用できます。以下にいくつかの例を示します。

1. ユーザー入力の検証

ユーザーが入力した値が許可されたリストに含まれているかをチェックする例：

using System;
using System.Collections.Generic;

class UserInputValidationExample
{
    static void Main()
    {
        List<string> allowedColors = new List<string> { "赤", "青", "緑", "黄" };

        Console.Write("好きな色を入力してください: ");
        string userInput = Console.ReadLine();

        if (allowedColors.Contains(userInput))
        {
            Console.WriteLine($"{userInput}は許可された色です。");
        }
        else
        {
            Console.WriteLine($"{userInput}は許可されていません。許可された色は {string.Join(", ", allowedColors)} です。");
        }
    }
}

この例では、ユーザーの入力が許可された色のリストに含まれているかをチェックしています。

2. 重複要素の除外

リストから重複する要素を除外して新しいリストを作成する例：

using System;
using System.Collections.Generic;
using System.Linq;

class RemoveDuplicatesExample
{
    static void Main()
    {
        List<int> numbers = new List<int> { 1, 2, 3, 2, 4, 3, 5, 1 };
        List<int> uniqueNumbers = new List<int>();

        foreach (int number in numbers)
        {
            if (!uniqueNumbers.Contains(number))
            {
                uniqueNumbers.Add(number);
            }
        }

        Console.WriteLine("元のリスト: " + string.Join(", ", numbers));
        Console.WriteLine("重複を除いたリスト: " + string.Join(", ", uniqueNumbers));
    }
}

この例では、Contains メソッドを使用して、新しいリストに要素が既に存在するかをチェックし、重複を除外しています。

注意点

List<T>.Contains(T) メソッドは、値型（int, double など）と参照型（string, カスタムクラスなど）で動作が異なります。値型の場合は値の比較、参照型の場合は参照の比較を行います。
カスタムクラスを使用する場合、Equals メソッドと GetHashCode メソッドをオーバーライドして、正しい比較ロジックを実装する必要があります。
大規模なリストに対して頻繁に Contains を呼び出す場合、パフォーマンスの問題が発生する可能性があります。そのような場合は、HashSet<T> の使用を検討してください。