Queue<T>.TrimExcess Method

Definition

Overloads

TrimExcess()

Sets the capacity to the actual number of elements in the Queue<T>, if that number is less than 90 percent of current capacity.

TrimExcess(Int32)

Sets the capacity of a Queue<T> object to the specified number of entries.

TrimExcess()

Source:
Queue.cs
Source:
Queue.cs
Source:
Queue.cs

Sets the capacity to the actual number of elements in the Queue<T>, if that number is less than 90 percent of current capacity.

public:
 void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()

Remarks

This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. The cost of reallocating and copying a large Queue<T> can be considerable, however, so the TrimExcess method does nothing if the list is at more than 90 percent of capacity. This avoids incurring a large reallocation cost for a relatively small gain.

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

To reset a Queue<T> to its initial state, call the Clear method before calling TrimExcess method. Trimming an empty Queue<T> sets the capacity of the Queue<T> to the default capacity.

See also

Applies to

TrimExcess(Int32)

Source:
Queue.cs

Sets the capacity of a Queue<T> object to the specified number of entries.

public:
 void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

Parameters

capacity
Int32

The new capacity.

Exceptions

Passed capacity is lower than entries count.

Applies to