C#のQueue.Equals()メソッドの使い方を徹底解説

C#におけるQueue.Equals()メソッドは、あるキュー（Queue）オブジェクトが別のキューオブジェクトと等しいかどうかを判定するために使用されます。このメソッドは、オブジェクト同士の比較を行い、結果を真偽値（bool）として返します。

構文

Queue.Equals()メソッドの構文は以下のとおりです。

public virtual bool Equals (object obj);

パラメータobjには、比較対象となるオブジェクトを指定します。現在のインスタンスとobjが同一の参照を持つ場合はtrueを返し、そうでない場合はfalseを返します。

使用例1：同じキュー同士の比較

まず、キュー自身と比較した場合の動作を見てみましょう。

using System;
using System.Collections.Generic;
public class Demo {
    public static void Main(){
        Queue<string> queue = new Queue<string>();
        queue.Enqueue("Gary");
        queue.Enqueue("Jack");
        queue.Enqueue("Ryan");
        queue.Enqueue("Kevin");
        queue.Enqueue("Mark");
        queue.Enqueue("Jack");
        queue.Enqueue("Ryan");
        queue.Enqueue("Kevin");
        Console.WriteLine(queue.Equals(queue));
        Console.Write("要素数 = ");
        Console.WriteLine(queue.Count);
        queue.Clear();
        Console.Write("要素数（更新後） = ");
        Console.WriteLine(queue.Count);
    }
}

出力結果

上記のコードを実行すると、以下の出力が得られます。

True
要素数 = 8
要素数（更新後） = 0

この例では、キューに対して自分自身を比較しているため、Equals()メソッドはtrueを返します。また、Clear()メソッドを呼び出すことで、すべての要素が削除され、要素数が0になっていることが確認できます。

使用例2：異なるキュー同士の比較

次に、内容の異なる2つのキューを比較した場合の例を見てみましょう。

using System;
using System.Collections;
public class Demo {
    public static void Main(){
        Queue queue = new Queue();
        queue.Enqueue(100);
        queue.Enqueue(200);
        queue.Enqueue(300);
        queue.Enqueue(400);
        Queue queue2 = new Queue();
        queue2.Enqueue(100);
        queue2.Enqueue(150);
        queue2.Enqueue(300);
        queue2.Enqueue(400);
        Console.WriteLine(queue.Equals(queue2));
    }
}

出力結果

上記のコードを実行すると、以下の出力が得られます。

False

注意点

Equals()メソッドは既定では参照の等価性を比較するため、たとえ2つのキューに同じ要素が同じ順序で格納されていても、別々のインスタンスであればfalseが返されます。上記の例でも、2番目のキューの要素「200」が「150」に置き換わっている点に加えて、両者が異なるオブジェクトであるためfalseという結果になっています。

要素ごとの内容を比較したい場合は、ループ処理やLINQのSequenceEqual()メソッドなどを活用することをおすすめします。