Queue.Enqueue(Object) Método

Definição

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Origem:

Queue.cs

Adiciona um objeto ao final do Queue.

public virtual void Enqueue (object? obj);

Parâmetros

obj

Object

O objeto a ser adicionado ao Queue. O valor pode ser null.

Exemplos

O exemplo a seguir mostra como adicionar elementos ao Queue, remover elementos do Queueou exibir o elemento no início do Queue.

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

*/

Comentários

A capacidade de um Queue é o número de elementos que o Queue pode conter. À medida que os elementos são adicionados a um Queue, a capacidade é automaticamente aumentada conforme necessário por meio da realocação. A capacidade pode ser reduzida chamando TrimToSize.

O fator de crescimento é o número pelo qual a capacidade atual é multiplicada quando uma capacidade maior é necessária. O fator de crescimento é determinado quando o Queue é construído. A capacidade do Queue sempre aumentará em um valor mínimo, independentemente do fator de crescimento; um fator de crescimento de 1,0 não impedirá que o Queue aumente de tamanho.

Se Count for menor que a capacidade da matriz interna, esse método será uma O(1) operação. Se a matriz interna precisar ser realocada para acomodar o novo elemento, esse método se tornará uma O(n) operação, em que n é Count.

Aplica-se a

Confira também

• Dequeue()
• Peek()