C# 0 The Complete Reference

Dequeue( )

. You can use 

Peek( )

 to return, but not remove, the next object. An 

InvalidOperationException

 is thrown if you call 

Dequeue( )

 or 

Peek( )

 when the invoking 

queue is empty.

www.freepdf-books.com

---

770

 

P a r t   I I :  

E x p l o r i n g   t h e   C #   L i b r a r y

Here is an example that demonstrates 

Queue

:

// Demonstrate the Queue class.

using System;

using System.Collections;

class QueueDemo {

  static void ShowEnq(Queue q, int a) {

    q.Enqueue(a);

    Console.WriteLine("Enqueue(" + a + ")");

    Console.Write("queue: ");

    foreach(int i in q)

      Console.Write(i + " ");

    Console.WriteLine();

  }

  static void ShowDeq(Queue q) {

    Console.Write("Dequeue -> ");

    int a = (int) q.Dequeue();

    Console.WriteLine(a);

    Console.Write("queue: ");

    foreach(int i in q)

      Console.Write(i + " ");

    Console.WriteLine();

  }

  static void Main() {

Method

Description

public vir tual void Clear( )

Sets 

Count

 to zero, which effectively clears 

the queue.

public vir tual bool Contains(object 

v

)

Returns true if 

v

 is in the invoking queue. If 

v

is not found, false is returned.

public vir tual object Dequeue( )

Returns the object at the front of the invoking 

queue. The object is removed in the process.

public vir tual void Enqueue(object 

v

)

Adds 

v

 to the end of the queue.

public vir tual object Peek( )

Returns the object at the front of the invoking 

queue, but does not remove it.

public static Queue Synchronized(Queue 

q

)

Returns a synchronized version of 

q.

public vir tual object[ ] ToArray( )

Returns an array that contains copies of the 

elements of the invoking queue.

public vir tual void TrimToSize( )

Sets 

Capacity

 to 

Count

.

T

ABLE

 24-8 

The Methods Defi ned by 

Queue

www.freepdf-books.com

---