Stack クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オブジェクトの単純な先入れ先出し (LIFO) 非ジェネリック コレクションを表します。
public ref class Stack : System::Collections::ICollection
public ref class Stack : ICloneable, System::Collections::ICollection
public class Stack : System.Collections.ICollection
public class Stack : ICloneable, System.Collections.ICollection
[System.Serializable]
public class Stack : ICloneable, System.Collections.ICollection
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Stack : ICloneable, System.Collections.ICollection
type Stack = class
interface ICollection
interface IEnumerable
type Stack = class
interface ICollection
interface IEnumerable
interface ICloneable
[<System.Serializable>]
type Stack = class
interface ICollection
interface IEnumerable
interface ICloneable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Stack = class
interface ICollection
interface IEnumerable
interface ICloneable
Public Class Stack
Implements ICollection
Public Class Stack
Implements ICloneable, ICollection
- 継承
-
Stack
- 属性
- 実装
例
次の例は、スタックに値を作成して追加する方法と、その値を表示する方法を示しています。
using System;
using System.Collections;
public class SamplesStack {
public static void Main() {
// Creates and initializes a new Stack.
Stack myStack = new Stack();
myStack.Push("Hello");
myStack.Push("World");
myStack.Push("!");
// Displays the properties and values of the Stack.
Console.WriteLine( "myStack" );
Console.WriteLine( "\tCount: {0}", myStack.Count );
Console.Write( "\tValues:" );
PrintValues( myStack );
}
public static void PrintValues( IEnumerable myCollection ) {
foreach ( Object obj in myCollection )
Console.Write( " {0}", obj );
Console.WriteLine();
}
}
/*
This code produces the following output.
myStack
Count: 3
Values: ! World Hello
*/
Imports System.Collections
Public Class SamplesStack
Public Shared Sub Main()
' Creates and initializes a new Stack.
Dim myStack As New Stack()
myStack.Push("Hello")
myStack.Push("World")
myStack.Push("!")
' Displays the properties and values of the Stack.
Console.WriteLine("myStack")
Console.WriteLine(ControlChars.Tab & "Count: {0}", myStack.Count)
Console.Write(ControlChars.Tab & "Values:")
PrintValues(myStack)
End Sub
Public Shared Sub PrintValues(myCollection As IEnumerable)
Dim obj As [Object]
For Each obj In myCollection
Console.Write(" {0}", obj)
Next obj
Console.WriteLine()
End Sub
End Class
' This code produces the following output.
'
' myStack
' Count: 3
' Values: ! World Hello
注釈
Stackの容量は、Stackが保持できる要素の数です。 要素が Stackに追加されると、再割り当てによって必要に応じて容量が自動的に増加します。
Important
新しい開発には Stack クラスを使用しないことをお勧めします。 代わりに、ジェネリック System.Collections.Generic.Stack<T> クラスを使用することをお勧めします。 詳細については、「 非ジェネリック コレクションは GitHub で使用しないでください」を参照してください。
Countがスタックの容量より小さい場合、PushはO(1)操作です。 新しい要素に対応するために容量を増やす必要がある場合、PushはO(n)がnCount操作になります。
Pop は O(1) 操作です。
Stack は null を有効な値として受け取り、重複する要素を許可します。
コンストラクター
| 名前 | 説明 |
|---|---|
| Stack() |
空で、既定の初期容量を持つ Stack クラスの新しいインスタンスを初期化します。 |
| Stack(ICollection) |
指定したコレクションからコピーされた要素を含み、コピーされた要素の数と同じ初期容量を持つ、 Stack クラスの新しいインスタンスを初期化します。 |
| Stack(Int32) |
空で、指定した初期容量または既定の初期容量のいずれか大きい方の Stack クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Count |
Stackに含まれる要素の数を取得します。 |
| IsSynchronized |
Stackへのアクセスが同期されているかどうかを示す値を取得します (スレッド セーフ)。 |
| SyncRoot |
Stackへのアクセスを同期するために使用できるオブジェクトを取得します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Clear() |
Stackからすべてのオブジェクトを削除します。 |
| Clone() |
Stackの簡易コピーを作成します。 |
| Contains(Object) |
要素が Stack内にあるかどうかを判断します。 |
| CopyTo(Array, Int32) | |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetEnumerator() |
IEnumeratorのStackを返します。 |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| Peek() |
Stackの上部にあるオブジェクトを削除せずに返します。 |
| Pop() |
Stackの上部にあるオブジェクトを削除して返します。 |
| Push(Object) |
Stackの上部にオブジェクトを挿入します。 |
| Synchronized(Stack) |
Stackの同期 (スレッド セーフ) ラッパーを返します。 |
| ToArray() |
Stackを新しい配列にコピーします。 |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
拡張メソッド
| 名前 | 説明 |
|---|---|
| AsParallel(IEnumerable) |
クエリの並列化を有効にします。 |
| AsQueryable(IEnumerable) |
IEnumerable を IQueryableに変換します。 |
| Cast<TResult>(IEnumerable) |
IEnumerable の要素を指定した型にキャストします。 |
| OfType<TResult>(IEnumerable) |
指定した型に基づいて、IEnumerable の要素をフィルター処理します。 |
適用対象
スレッド セーフ
この型のパブリック静的 (Visual Basic のShared ) メンバーはスレッド セーフです。 インスタンス メンバーがスレッド セーフであるとは限りません。
Stackのスレッド セーフを保証するには、Synchronized(Stack) メソッドによって返されるラッパーを通じてすべての操作を実行する必要があります。
コレクションを列挙することは、本質的にスレッド セーフなプロシージャではありません。 コレクションが同期されている場合でも、他のスレッドはコレクションを変更できるため、列挙子は例外をスローします。 列挙中のスレッド セーフを保証するには、列挙全体の間にコレクションをロックするか、他のスレッドによって行われた変更によって発生する例外をキャッチします。