C#のQueue.TrimExcess()メソッドをサンプルコードで解説

C#のQueue.TrimExcess()メソッドは、キュー（Queue<T>）内の実際の要素数が現在の容量の90%未満である場合に、容量をその要素数にまで縮小するためのメソッドです。不要なメモリを解放し、メモリ使用量を最適化したい場合に役立ちます。

構文

public void TrimExcess ();

サンプルコード1

以下の例では、整数型のキューに10個の要素を追加した後、Clear()メソッドですべての要素を削除し、TrimExcess()メソッドを呼び出して容量を縮小しています。

using System;
using System.Collections.Generic;
public class Demo {
    public static void Main() {
        Queue<int> queue = new Queue<int>();
        queue.Enqueue(100);
        queue.Enqueue(200);
        queue.Enqueue(300);
        queue.Enqueue(400);
        queue.Enqueue(500);
        queue.Enqueue(600);
        queue.Enqueue(700);
        queue.Enqueue(800);
        queue.Enqueue(900);
        queue.Enqueue(1000);
        Console.WriteLine("キューの内容...");
        foreach(int i in queue) {
            Console.WriteLine(i);
        }
        Console.WriteLine("キュー内の要素数 = "+queue.Count);
        queue.Clear();
        queue.TrimExcess();
        Console.WriteLine("キュー内の要素数 [更新後] = "+queue.Count);
    }
}

出力結果

100
200
300
400
500
600
700
800
900
1000
キュー内の要素数 = 10
キュー内の要素数 [更新後] = 0

サンプルコード2

次の例では、文字列型のキューを使用しています。Contains()メソッドで特定の要素が含まれているかを確認した後、TrimExcess()を呼び出し、さらにClear()で要素をすべて削除しています。

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.Write("要素数 = ");
        Console.WriteLine(queue.Count);
        Console.WriteLine("キューに"Jack"は含まれているか？ = "+queue.Contains("Jack"));
        queue.TrimExcess();
        queue.Clear();
        Console.Write("要素数（更新後） = ");
        Console.WriteLine(queue.Count);
    }
}

出力結果

要素数 = 8
キューに"Jack"は含まれているか？ = True
要素数（更新後） = 0

ポイントまとめ

• TrimExcess()は、要素数が現在の容量の90%未満の場合にのみ容量を縮小します。
• 大量の要素を削除した後など、メモリを効率的に管理したい場面で活用できます。
• 頻繁に呼び出すと再割り当てのコストが発生するため、必要なタイミングでのみ使用することが推奨されます。