Enumerable.SequenceEqual メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.dll

等値比較子に従って 2 つのシーケンスが等しいかどうかを判断します。

オーバーロード

SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	要素の型に対して既定の等値比較子を使用して要素を比較することで、2 つのシーケンスが等しいかどうかを判断します。
SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	指定された IEqualityComparer<T> を使用して要素を比較することで、2 つのシーケンスが等しいかどうかを判断します。

SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)

ソース:

SequenceEqual.cs

要素の型に対して既定の等値比較子を使用して要素を比較することで、2 つのシーケンスが等しいかどうかを判断します。

C#

public static bool SequenceEqual<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second);

型パラメーター

TSource

入力シーケンスの要素の型。

パラメーター

first

IEnumerable<TSource>

second と比較する IEnumerable<T>。

second

IEnumerable<TSource>

最初のシーケンスと比較する IEnumerable<T>。

戻り値

Boolean

2 つのソース シーケンスが同じ長さで、それらに対応する要素がその型の既定の等値比較子に従って等しい場合は true。それ以外の場合は false。

例外

ArgumentNullException

first または second が null です。

例

次のコード例は、 を使用 SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) して 2 つのシーケンスが等しいかどうかを判断する方法を示しています。 最初の 2 つの例では、 メソッドによって、比較されるシーケンスに同じオブジェクトへの参照が含まれているかどうかを判断します。 3 番目と 4 番目の例では、 メソッドはシーケンス内のオブジェクトの実際のデータを比較します。

この例では、シーケンスは等しくなります。

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void SequenceEqualEx1()
{
    Pet pet1 = new Pet { Name = "Turbo", Age = 2 };
    Pet pet2 = new Pet { Name = "Peanut", Age = 8 };

    // Create two lists of pets.
    List<Pet> pets1 = new List<Pet> { pet1, pet2 };
    List<Pet> pets2 = new List<Pet> { pet1, pet2 };

    bool equal = pets1.SequenceEqual(pets2);

    Console.WriteLine(
        "The lists {0} equal.",
        equal ? "are" : "are not");
}

/*
 This code produces the following output:

 The lists are equal.
*/

次のコード例では、等しくない 2 つのシーケンスを比較します。 シーケンスには同じデータが含まれていますが、そのシーケンスに含まれるオブジェクトの参照が異なるため、シーケンスは等しいとは見なされません。

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void SequenceEqualEx2()
{
    Pet pet1 = new Pet() { Name = "Turbo", Age = 2 };
    Pet pet2 = new Pet() { Name = "Peanut", Age = 8 };

    // Create two lists of pets.
    List<Pet> pets1 = new List<Pet> { pet1, pet2 };
    List<Pet> pets2 =
        new List<Pet> { new Pet { Name = "Turbo", Age = 2 },
                        new Pet { Name = "Peanut", Age = 8 } };

    bool equal = pets1.SequenceEqual(pets2);

    Console.WriteLine("The lists {0} equal.", equal ? "are" : "are not");
}

/*
 This code produces the following output:

 The lists are not equal.
*/

参照を比較するのではなく、シーケンス内のオブジェクトの実際のデータを比較する場合は、クラスにジェネリック インターフェイスを IEqualityComparer<T> 実装する必要があります。 次のコード例は、ヘルパー クラスでこのインターフェイスを実装し、 メソッドと Equals メソッドを提供GetHashCodeする方法を示しています。

C#

public class ProductA : IEquatable<ProductA>
{
    public string Name { get; set; }
    public int Code { get; set; }

    public bool Equals(ProductA other)
    {
        if (other is null)
            return false;

        return this.Name == other.Name && this.Code == other.Code;
    }

    public override bool Equals(object obj) => Equals(obj as ProductA);
    public override int GetHashCode() => (Name, Code).GetHashCode();
}

このインターフェイスを実装した後、次の例に示すように、 メソッドでSequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)オブジェクトのProductAシーケンスを使用できます。

C#

ProductA[] storeA = { new ProductA { Name = "apple", Code = 9 },
                       new ProductA { Name = "orange", Code = 4 } };

ProductA[] storeB = { new ProductA { Name = "apple", Code = 9 },
                       new ProductA { Name = "orange", Code = 4 } };

bool equalAB = storeA.SequenceEqual(storeB);

Console.WriteLine("Equal? " + equalAB);

/*
    This code produces the following output:

    Equal? True
*/

注釈

メソッドはSequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)、2 つのソース シーケンスを並列に列挙し、 の既定の等値比較子を使用して対応する要素をTSourceDefault比較します。

既定の等値比較子 は、 Default型の値を比較するために使用されます。 カスタム データ型を比較するには、 メソッドと GetHashCode メソッドをオーバーライドEqualsし、必要に応じてカスタム型にジェネリック インターフェイスを実装IEquatable<T>する必要があります。 詳細については、Default プロパティを参照してください。

SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)

ソース:

SequenceEqual.cs

指定された IEqualityComparer<T> を使用して要素を比較することで、2 つのシーケンスが等しいかどうかを判断します。

C#

public static bool SequenceEqual<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

型パラメーター

TSource

入力シーケンスの要素の型。

パラメーター

first

IEnumerable<TSource>

second と比較する IEnumerable<T>。

second

IEnumerable<TSource>

最初のシーケンスと比較する IEnumerable<T>。

comparer

IEqualityComparer<TSource>

要素の比較に使用する IEqualityComparer<T>。

戻り値

Boolean

2 つのソース シーケンスが同じ長さで、comparer に従ってそれらに対応する要素が等しい場合は true。それ以外の場合は false。

例外

ArgumentNullException

first または second が null です。

例

次の例は、 メソッドで使用できる等価比較子を実装する方法を SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 示しています。

C#

public class Product
{
    public string Name { get; set; }
    public int Code { get; set; }
}

// Custom comparer for the Product class
class ProductComparer : IEqualityComparer<Product>
{
    // Products are equal if their names and product numbers are equal.
    public bool Equals(Product x, Product y)
    {

        //Check whether the compared objects reference the same data.
        if (Object.ReferenceEquals(x, y)) return true;

        //Check whether any of the compared objects is null.
        if (Object.ReferenceEquals(x, null) || Object.ReferenceEquals(y, null))
            return false;

        //Check whether the products' properties are equal.
        return x.Code == y.Code && x.Name == y.Name;
    }

    // If Equals() returns true for a pair of objects
    // then GetHashCode() must return the same value for these objects.

    public int GetHashCode(Product product)
    {
        //Check whether the object is null
        if (Object.ReferenceEquals(product, null)) return 0;

        //Get hash code for the Name field if it is not null.
        int hashProductName = product.Name == null ? 0 : product.Name.GetHashCode();

        //Get hash code for the Code field.
        int hashProductCode = product.Code.GetHashCode();

        //Calculate the hash code for the product.
        return hashProductName ^ hashProductCode;
    }
}

この比較子を実装した後、次の例に示すように、 メソッドでSequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)オブジェクトのProductシーケンスを使用できます。

C#

Product[] storeA = { new Product { Name = "apple", Code = 9 },
                       new Product { Name = "orange", Code = 4 } };

Product[] storeB = { new Product { Name = "apple", Code = 9 },
                       new Product { Name = "orange", Code = 4 } };

bool equalAB = storeA.SequenceEqual(storeB, new ProductComparer());

Console.WriteLine("Equal? " + equalAB);

/*
    This code produces the following output:

    Equal? True
*/

注釈

メソッドは SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 、2 つのソース シーケンスを並列に列挙し、指定した IEqualityComparer<T>を使用して対応する要素を比較します。 が nullの場合comparer、Default既定の等値比較子 である が要素の比較に使用されます。