Прочитать на английском

Поделиться через


Stack<T>.CopyTo(T[], Int32) Метод

Определение

Копирует Stack<T> в существующий одномерный Array, начиная с указанного индекса массива.

public void CopyTo (T[] array, int arrayIndex);

Параметры

array
T[]

Одномерный массив Array, в который копируются элементы из интерфейса Stack<T>. Массив Array должен иметь индексацию, начинающуюся с нуля.

arrayIndex
Int32

Отсчитываемый от нуля индекс в массиве array, указывающий начало копирования.

Исключения

array имеет значение null.

Значение параметра arrayIndex меньше нуля.

Число элементов в исходной коллекции Stack<T> больше доступного места от положения, заданного значением параметра arrayIndex, до конца массива назначения array.

Примеры

В следующем примере кода демонстрируется несколько методов универсального Stack<T> класса, включая CopyTo метод .

В примере кода создается стек строк с емкостью по умолчанию и используется Push метод для отправки пяти строк в стек. Элементы стека перечисляются, что не изменяет состояние стека. Метод Pop используется для того, чтобы извлечь первую строку из стека. Метод Peek используется для просмотра следующего элемента в стеке, а затем Pop метод используется для его отключения.

Метод ToArray используется для создания массива и копирования в него элементов стека, а затем массив передается конструктору Stack<T> , который принимает IEnumerable<T>, создавая копию стека с обратным порядком элементов. Отображаются элементы копии.

Создается массив в два раза больше размера стека, а CopyTo метод используется для копирования элементов массива, начиная с середины массива. Конструктор Stack<T> снова используется для создания копии стека с обратным порядком элементов; таким образом, три элемента NULL находятся в конце.

Метод Contains используется для отображения того, что строка "четыре" находится в первой копии стека, после чего Clear метод очищает копию, а Count свойство показывает, что стек пуст.

using System;
using System.Collections.Generic;

class Example
{
    public static void Main()
    {
        Stack<string> numbers = new Stack<string>();
        numbers.Push("one");
        numbers.Push("two");
        numbers.Push("three");
        numbers.Push("four");
        numbers.Push("five");

        // A stack can be enumerated without disturbing its contents.
        foreach( string number in numbers )
        {
            Console.WriteLine(number);
        }

        Console.WriteLine("\nPopping '{0}'", numbers.Pop());
        Console.WriteLine("Peek at next item to destack: {0}",
            numbers.Peek());
        Console.WriteLine("Popping '{0}'", numbers.Pop());

        // Create a copy of the stack, using the ToArray method and the
        // constructor that accepts an IEnumerable<T>.
        Stack<string> stack2 = new Stack<string>(numbers.ToArray());

        Console.WriteLine("\nContents of the first copy:");
        foreach( string number in stack2 )
        {
            Console.WriteLine(number);
        }

        // Create an array twice the size of the stack and copy the
        // elements of the stack, starting at the middle of the
        // array.
        string[] array2 = new string[numbers.Count * 2];
        numbers.CopyTo(array2, numbers.Count);

        // Create a second stack, using the constructor that accepts an
        // IEnumerable(Of T).
        Stack<string> stack3 = new Stack<string>(array2);

        Console.WriteLine("\nContents of the second copy, with duplicates and nulls:");
        foreach( string number in stack3 )
        {
            Console.WriteLine(number);
        }

        Console.WriteLine("\nstack2.Contains(\"four\") = {0}",
            stack2.Contains("four"));

        Console.WriteLine("\nstack2.Clear()");
        stack2.Clear();
        Console.WriteLine("\nstack2.Count = {0}", stack2.Count);
    }
}

/* This code example produces the following output:

five
four
three
two
one

Popping 'five'
Peek at next item to destack: four
Popping 'four'

Contents of the first copy:
one
two
three

Contents of the second copy, with duplicates and nulls:
one
two
three




stack2.Contains("four") = False

stack2.Clear()

stack2.Count = 0
 */

Комментарии

Элементы копируются в массив в порядке последнего выхода (LIFO), аналогично порядку элементов, возвращаемых последовательности вызовов Pop.

Этот метод является операцией O(n), где n — .Count

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел