Queue.Enqueue メソッド
アセンブリ: mscorlib (mscorlib.dll 内)


Queue の容量は、Queue が保持できる要素数になります。Queue に要素を追加すると、必要に応じて、再割り当てを行うことによって容量が自動的に増加します。容量を減らすには、TrimToSize を呼び出します。
増加率は、容量を増やす必要がある場合に、現在の容量に掛け合わせる数値です。増加率は Queue が生成された時点で決定します。
Count が内部配列の容量よりも小さい場合、このメソッドは O(1) 操作になります。新しい要素を格納できるように内部配列を再割り当てする必要がある場合、このメソッドは O(n) 操作になります。ここで、n は Count です。

Queue に要素を追加する方法、Queue から要素を削除する方法、または Queue の先頭にある要素を参照する方法の例を次に示します。
Imports System Imports System.Collections Imports Microsoft.VisualBasic Public Class SamplesQueue Public Shared Sub Main() ' Creates and initializes a new Queue. Dim myQ As New Queue() myQ.Enqueue("The") myQ.Enqueue("quick") myQ.Enqueue("brown") myQ.Enqueue("fox") ' Displays the Queue. Console.Write("Queue values:") PrintValues(myQ) ' Removes an element from the Queue. Console.WriteLine("(Dequeue) {0}", myQ.Dequeue()) ' Displays the Queue. Console.Write("Queue values:") PrintValues(myQ) ' Removes another element from the Queue. Console.WriteLine("(Dequeue) {0}", myQ.Dequeue()) ' Displays the Queue. Console.Write("Queue values:") PrintValues(myQ) ' Views the first element in the Queue but does not remove it. Console.WriteLine("(Peek) {0}", myQ.Peek()) ' Displays the Queue. Console.Write("Queue values:") PrintValues(myQ) End Sub 'Main 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 'PrintValues End Class 'SamplesQueue ' This code produces the following output. ' ' Queue values: The quick brown fox ' (Dequeue) The ' Queue values: quick brown fox ' (Dequeue) quick ' Queue values: brown fox ' (Peek) brown ' Queue values: brown fox
using System; using System.Collections; public class SamplesQueue { public static void Main() { // Creates and initializes a new Queue. Queue myQ = new Queue(); myQ.Enqueue( "The" ); myQ.Enqueue( "quick" ); myQ.Enqueue( "brown" ); myQ.Enqueue( "fox" ); // Displays the Queue. Console.Write( "Queue values:" ); PrintValues( myQ ); // Removes an element from the Queue. Console.WriteLine( "(Dequeue)\t{0}", myQ.Dequeue() ); // Displays the Queue. Console.Write( "Queue values:" ); PrintValues( myQ ); // Removes another element from the Queue. Console.WriteLine( "(Dequeue)\t{0}", myQ.Dequeue() ); // Displays the Queue. Console.Write( "Queue values:" ); PrintValues( myQ ); // Views the first element in the Queue but does not remove it. Console.WriteLine( "(Peek) \t{0}", myQ.Peek() ); // Displays the Queue. Console.Write( "Queue values:" ); PrintValues( myQ ); } public static void PrintValues( IEnumerable myCollection ) { foreach ( Object obj in myCollection ) Console.Write( " {0}", obj ); Console.WriteLine(); } } /* This code produces the following output. Queue values: The quick brown fox (Dequeue) The Queue values: quick brown fox (Dequeue) quick Queue values: brown fox (Peek) brown Queue values: brown fox */
using namespace System; using namespace System::Collections; void PrintValues( IEnumerable^ myCollection ); int main() { // Creates and initializes a new Queue. Queue^ myQ = gcnew Queue; myQ->Enqueue( "The" ); myQ->Enqueue( "quick" ); myQ->Enqueue( "brown" ); myQ->Enqueue( "fox" ); // Displays the Queue. Console::Write( "Queue values:" ); PrintValues( myQ ); // Removes an element from the Queue. Console::WriteLine( "(Dequeue)\t{0}", myQ->Dequeue() ); // Displays the Queue. Console::Write( "Queue values:" ); PrintValues( myQ ); // Removes another element from the Queue. Console::WriteLine( "(Dequeue)\t{0}", myQ->Dequeue() ); // Displays the Queue. Console::Write( "Queue values:" ); PrintValues( myQ ); // Views the first element in the Queue but does not remove it. Console::WriteLine( "(Peek) \t{0}", myQ->Peek() ); // Displays the Queue. Console::Write( "Queue values:" ); PrintValues( myQ ); } void PrintValues( IEnumerable^ myCollection ) { IEnumerator^ myEnum = myCollection->GetEnumerator(); while ( myEnum->MoveNext() ) { Object^ obj = safe_cast<Object^>(myEnum->Current); Console::Write( " {0}", obj ); } Console::WriteLine(); } /* This code produces the following output. Queue values: The quick brown fox (Dequeue) The Queue values: quick brown fox (Dequeue) quick Queue values: brown fox (Peek) brown Queue values: brown fox */
import System.*; import System.Collections.*; public class SamplesQueue { public static void main(String[] args) { // Creates and initializes a new Queue. Queue myQ = new Queue(); myQ.Enqueue("The"); myQ.Enqueue("quick"); myQ.Enqueue("brown"); myQ.Enqueue("fox"); // Displays the Queue. Console.Write("Queue values:"); PrintValues(myQ); // Removes an element from the Queue. Console.WriteLine("(Dequeue)\t{0}", myQ.Dequeue()); // Displays the Queue. Console.Write("Queue values:"); PrintValues(myQ); // Removes another element from the Queue. Console.WriteLine("(Dequeue)\t{0}", myQ.Dequeue()); // Displays the Queue. Console.Write("Queue values:"); PrintValues(myQ); // Views the first element in the Queue but does not remove it. Console.WriteLine("(Peek) \t{0}", myQ.Peek()); // Displays the Queue. Console.Write("Queue values:"); PrintValues(myQ); } //main public static void PrintValues(IEnumerable myCollection) { IEnumerator e = myCollection.GetEnumerator(); while (e.MoveNext()) { Object obj = e.get_Current(); Console.Write(" {0}", obj); } Console.WriteLine(); } //PrintValues } //SamplesQueue /* This code produces the following output. Queue values: The quick brown fox (Dequeue) The Queue values: quick brown fox (Dequeue) quick Queue values: brown fox (Peek) brown Queue values: brown fox */

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


Queue.Enqueue メソッド
アセンブリ: System (system.dll 内)


Count が既に容量に等しい場合には、内部配列を自動的に再割り当てすることにより Queue の容量が増加し、新しい要素を追加する前に既存の要素は新しい配列にコピーされます。
Count が内部配列の容量よりも小さい場合、このメソッドは O(1) 操作になります。新しい要素を格納できるように内部配列を再割り当てする必要がある場合、このメソッドは O(n) 操作になります。ここで、n は Count です。

Enqueue メソッドを含む、Queue ジェネリック クラスのいくつかのメソッドを使用したコード例を次に示します。
このコード例では、既定の容量で文字列のキューを作成し、Enqueue メソッドを使用して 5 つの文字列をキューに置きます。キューの要素は列挙されますが、キューの状態は変化しません。Dequeue メソッドを使用して、最初の文字列をキューから取り出します。Peek メソッドを使用してキュー内の次の項目を調べてから、Dequeue メソッドを使用してキューから取り出します。
ToArray メソッドを使用して配列を作成し、その配列にキュー要素をコピーしてから、IEnumerable を受け取る Queue コンストラクタに配列を渡してキューのコピーを作成します。コピーの要素が表示されます。
キューの 2 倍のサイズの配列が作成され、CopyTo メソッドを使用して配列の中央部で始まる配列要素をコピーします。Queue コンストラクタを再度使用して、先頭に 3 つの null 要素を含むキューの 2 つ目のコピーを作成します。
Contains メソッドにより、文字列 "four" がキューの最初のコピーに含まれていることを示します。その後で、Clear メソッドがコピーをクリアすると、Count プロパティによってキューが空であることが示されます。
Imports System Imports System.Collections.Generic Module Example Sub Main Dim numbers As New Queue(Of String) numbers.Enqueue("one") numbers.Enqueue("two") numbers.Enqueue("three") numbers.Enqueue("four") numbers.Enqueue("five") ' A queue can be enumerated without disturbing its contents. For Each number As String In numbers Console.WriteLine(number) Next Console.WriteLine(vbLf & "Dequeuing '{0}'", numbers.Dequeue()) Console.WriteLine("Peek at next item to dequeue: {0}", _ numbers.Peek()) Console.WriteLine("Dequeuing '{0}'", numbers.Dequeue()) ' Create a copy of the queue, using the ToArray method and the ' constructor that accepts an IEnumerable(Of T). Dim queueCopy As New Queue(Of String)(numbers.ToArray()) Console.WriteLine(vbLf & "Contents of the first copy:") For Each number As String In queueCopy Console.WriteLine(number) Next ' Create an array twice the size of the queue, compensating ' for the fact that Visual Basic allocates an extra array ' element. Copy the elements of the queue, starting at the ' middle of the array. Dim array2((numbers.Count * 2) - 1) As String numbers.CopyTo(array2, numbers.Count) ' Create a second queue, using the constructor that accepts an ' IEnumerable(Of T). Dim queueCopy2 As New Queue(Of String)(array2) Console.WriteLine(vbLf & _ "Contents of the second copy, with duplicates and nulls:") For Each number As String In queueCopy2 Console.WriteLine(number) Next Console.WriteLine(vbLf & "queueCopy.Contains(""four"") = {0}", _ queueCopy.Contains("four")) Console.WriteLine(vbLf & "queueCopy.Clear()") queueCopy.Clear() Console.WriteLine(vbLf & "queueCopy.Count = {0}", _ queueCopy.Count) End Sub End Module ' This code example produces the following output: ' 'one 'two 'three 'four 'five ' 'Dequeuing 'one' 'Peek at next item to dequeue: two ' 'Dequeuing 'two' ' 'Contents of the copy: 'three 'four 'five ' 'Contents of the second copy, with duplicates and nulls: ' ' ' 'three 'four 'five ' 'queueCopy.Contains("four") = True ' 'queueCopy.Clear() ' 'queueCopy.Count = 0
using System; using System.Collections.Generic; class Example { public static void Main() { Queue<string> numbers = new Queue<string>(); numbers.Enqueue("one"); numbers.Enqueue("two"); numbers.Enqueue("three"); numbers.Enqueue("four"); numbers.Enqueue("five"); // A queue can be enumerated without disturbing its contents. foreach( string number in numbers ) { Console.WriteLine(number); } Console.WriteLine("\nDequeuing '{0}'", numbers.Dequeue()); Console.WriteLine("Peek at next item to dequeue: {0}", numbers.Peek()); Console.WriteLine("Dequeuing '{0}'", numbers.Dequeue()); // Create a copy of the queue, using the ToArray method and the // constructor that accepts an IEnumerable<T>. Queue<string> queueCopy = new Queue<string>(numbers.ToArray()); Console.WriteLine("\nContents of the first copy:"); foreach( string number in queueCopy ) { Console.WriteLine(number); } // Create an array twice the size of the queue and copy the // elements of the queue, starting at the middle of the // array. string[] array2 = new string[numbers.Count * 2]; numbers.CopyTo(array2, numbers.Count); // Create a second queue, using the constructor that accepts an // IEnumerable(Of T). Queue<string> queueCopy2 = new Queue<string>(array2); Console.WriteLine("\nContents of the second copy, with duplicates and nulls:"); foreach( string number in queueCopy2 ) { Console.WriteLine(number); } Console.WriteLine("\nqueueCopy.Contains(\"four\") = {0}", queueCopy.Contains("four")); Console.WriteLine("\nqueueCopy.Clear()"); queueCopy.Clear(); Console.WriteLine("\nqueueCopy.Count = {0}", queueCopy.Count); } } /* This code example produces the following output: one two three four five Dequeuing 'one' Peek at next item to dequeue: two Dequeuing 'two' Contents of the copy: three four five Contents of the second copy, with duplicates and nulls: three four five queueCopy.Contains("four") = True queueCopy.Clear() queueCopy.Count = 0 */

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- Queue.Enqueueのページへのリンク