Stack.ToArray Method

public:
 virtual cli::array <System::Object ^> ^ ToArray();

public virtual object[] ToArray();

public virtual object?[] ToArray();

abstract member ToArray : unit -> obj[]
override this.ToArray : unit -> obj[]

Public Overridable Function ToArray () As Object()

Returns

A new array containing copies of the elements of the Stack.

Examples

The following example shows how to copy a Stack into a one-dimensional array.

using System;
using System.Collections;
public class SamplesStack {

 public static void Main() {

 // Creates and initializes the source Stack.
 Stack mySourceQ = new Stack();
 mySourceQ.Push( "barn" );
 mySourceQ.Push( "the" );
 mySourceQ.Push( "in" );
 mySourceQ.Push( "cats" );
 mySourceQ.Push( "napping" );
 mySourceQ.Push( "three" );

 // Creates and initializes the one-dimensional target Array.
 Array myTargetArray=Array.CreateInstance( typeof(string), 15 );
 myTargetArray.SetValue( "The", 0 );
 myTargetArray.SetValue( "quick", 1 );
 myTargetArray.SetValue( "brown", 2 );
 myTargetArray.SetValue( "fox", 3 );
 myTargetArray.SetValue( "jumps", 4 );
 myTargetArray.SetValue( "over", 5 );
 myTargetArray.SetValue( "the", 6 );
 myTargetArray.SetValue( "lazy", 7 );
 myTargetArray.SetValue( "dog", 8 );

 // Displays the values of the target Array.
 Console.WriteLine( "The target Array contains the following (before and after copying):" );
 PrintValues( myTargetArray, ' ' );

 // Copies the entire source Stack to the target Array, starting at index 6.
 mySourceQ.CopyTo( myTargetArray, 6 );

 // Displays the values of the target Array.
 PrintValues( myTargetArray, ' ' );

 // Copies the entire source Stack to a new standard array.
 Object[] myStandardArray = mySourceQ.ToArray();

 // Displays the values of the new standard array.
 Console.WriteLine( "The new standard array contains the following:" );
 PrintValues( myStandardArray, ' ' );
 }

 public static void PrintValues( Array myArr, char mySeparator ) {
 foreach ( Object myObj in myArr ) {
 Console.Write( "{0}{1}", mySeparator, myObj );
 }
 Console.WriteLine();
 }
}


/*
This code produces the following output.

The target Array contains the following (before and after copying):
 The quick brown fox jumps over the lazy dog
 The quick brown fox jumps over three napping cats in the barn
The new standard array contains the following:
 three napping cats in the barn
*/

Imports System.Collections

Public Class SamplesStack 
 
 Public Shared Sub Main()
 
 ' Creates and initializes the source Stack.
 Dim mySourceQ As New Stack()
 mySourceQ.Push("barn")
 mySourceQ.Push("the")
 mySourceQ.Push("in")
 mySourceQ.Push("cats")
 mySourceQ.Push("napping")
 mySourceQ.Push("three")
 
 ' Creates and initializes the one-dimensional target Array.
 Dim myTargetArray As Array = Array.CreateInstance(GetType(String), 15)
 myTargetArray.SetValue("The", 0)
 myTargetArray.SetValue("quick", 1)
 myTargetArray.SetValue("brown", 2)
 myTargetArray.SetValue("fox", 3)
 myTargetArray.SetValue("jumps", 4)
 myTargetArray.SetValue("over", 5)
 myTargetArray.SetValue("the", 6)
 myTargetArray.SetValue("lazy", 7)
 myTargetArray.SetValue("dog", 8)
 
 ' Displays the values of the target Array.
 Console.WriteLine("The target Array contains the " & _
 "following (before and after copying):")
 PrintValues(myTargetArray, " "c)
 
 ' Copies the entire source Stack to the target Array, starting
 ' at index 6.
 mySourceQ.CopyTo(myTargetArray, 6)
 
 ' Displays the values of the target Array.
 PrintValues(myTargetArray, " "c)
 
 ' Copies the entire source Stack to a new standard array.
 Dim myStandardArray As Object() = mySourceQ.ToArray()
 
 ' Displays the values of the new standard array.
 Console.WriteLine("The new standard array contains the following:")
 PrintValues(myStandardArray, " "c)
 End Sub 
 
 Overloads Public Shared Sub PrintValues(myArr As Array, _
 mySeparator As Char)
 
 Dim myObj As Object
 For Each myObj In myArr
 Console.Write("{0}{1}", mySeparator, myObj)
 Next myObj
 Console.WriteLine()
 End Sub

End Class


' This code produces the following output.
'
' The target Array contains the following (before and after copying):
' The quick brown fox jumps over the lazy dog
' The quick brown fox jumps over three napping cats in the barn
' The new standard array contains the following:
' three napping cats in the barn

Remarks

The elements are copied onto the array in last-in-first-out (LIFO) order, similar to the order of the elements returned by a succession of calls to Pop.

This method is an O(n) operation, where n is Count.

See also

• CopyTo(Array, Int32)
• Pop()