【C#入門】Stack.Clear()メソッドの使い方｜スタック内の全要素を一括削除する方法

C#のStack.Clear()メソッドは、System.Collections名前空間に属するStackクラスのメソッドの一つで、スタック内に格納されているすべての要素（オブジェクト）を一括で削除するために使用されます。

このメソッドを実行すると、スタックのCountプロパティは0になり、スタックは初期状態に戻ります。なお、Clear()メソッドは戻り値を持たず、単純に全要素をクリアする動作のみを行います。

構文

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

public virtual void Clear();

• 戻り値： void型（値を返しません）
• 引数： なし

サンプルコード①：文字列を格納したStackの場合

まず、文字列をPush()メソッドでスタックに追加し、その後Clear()メソッドで全要素を削除する例を見てみましょう。

using System;
using System.Collections;

public class Demo {
   public static void Main() {
      Stack stack = new Stack();
      stack.Push("Inspiron");
      stack.Push("Alienware");
      stack.Push("Projectors");
      stack.Push("Monitors");
      stack.Push("XPS");
      stack.Push("Laptop");
      stack.Push("Notebook");

      Console.WriteLine("Stack elements...");
      foreach(string val in stack) {
         Console.WriteLine(val);
      }
      Console.WriteLine("Count of elements = " + stack.Count);

      stack.Push("Ultrabook");
      stack.Push("Cameras");
      stack.Push("Keyboards");

      Console.WriteLine("\nStack elements...updated");
      foreach(string val in stack) {
         Console.WriteLine(val);
      }
      Console.WriteLine("\nCount of elements (updated) = " + stack.Count);

      // 全要素を削除
      stack.Clear();
      Console.Write("Count of elements (after Clear) = " + stack.Count);
   }
}

実行結果

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

Stack elements...
Notebook
Laptop
XPS
Monitors
Projectors
Alienware
Inspiron
Count of elements = 7
Stack elements...updated
Keyboards
Cameras
Ultrabook
Notebook
Laptop
XPS
Monitors
Projectors
Alienware
Inspiron
Count of elements (updated) = 10
Count of elements (after Clear) = 0

実行結果からわかるように、最初に7つの要素を追加し、さらに3つ追加して合計10個になった後、stack.Clear()を呼び出すことで要素数が0になっていることが確認できます。

サンプルコード②：整数を格納したStackの場合

次に、整数値を扱う場合の例です。Stackは非ジェネリックコレクションのため、int型の値もそのまま格納できます。

using System;
using System.Collections;

public class Demo {
   public static void Main() {
      Stack stack = new Stack();
      stack.Push(150);
      stack.Push(300);
      stack.Push(500);
      stack.Push(750);
      stack.Push(1000);
      stack.Push(1250);
      stack.Push(1500);
      stack.Push(2000);
      stack.Push(2500);

      Console.WriteLine("Stack elements...");
      foreach(int val in stack) {
         Console.WriteLine(val);
      }
      Console.WriteLine("Count of elements = " + stack.Count);

      stack.Push(3000);
      stack.Push(3500);
      stack.Push(4000);

      Console.WriteLine("\nStack elements...updated");
      foreach(int val in stack) {
         Console.WriteLine(val);
      }
      Console.WriteLine("\nCount of elements (updated) = " + stack.Count);

      // 全要素を削除
      stack.Clear();
      Console.Write("Count of elements (after Clear) = " + stack.Count);
   }
}

実行結果

Stack elements...
2500
2000
1500
1250
1000
750
500
300
150
Count of elements = 9
Stack elements...updated
4000
3500
3000
2500
2000
1500
1250
1000
750
500
300
150
Count of elements (updated) = 12
Count of elements (after Clear) = 0

まとめ

C#のStack.Clear()メソッドについて、重要なポイントを整理します。

• Clear()メソッドはスタック内のすべての要素を削除します。
• 呼び出し後、Countプロパティは0になります。
• 戻り値はvoid型で、引数は取りません。
• スタック自体は破棄されず、引き続き新しい要素をPush()で追加できます。
• 特定の要素だけを削除したい場合は、Clear()ではなくPop()メソッドなどを使用します。

スタックの内容を完全にリセットしたい場面では、Clear()メソッドが非常に便利です。ぜひ活用してみてください。