Stack<T>.TrimExcess Method

Definition

Namespace:

System.Collections.Generic

Assemblies:

netstandard.dll, System.Collections.dll

Overloads

TrimExcess()	Sets the capacity to the actual number of elements in the Stack<T>, if that number is less than 90 percent of current capacity.
TrimExcess(Int32)	Sets the capacity of a Stack<T> object to a specified number of entries.

TrimExcess()

Source:

Stack.cs

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

C#

public void 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 Stack<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 Stack<T> to its initial state, call the Clear method before calling TrimExcess method. Trimming an empty Stack<T> sets the capacity of the Stack<T> to the default capacity.

See also

• Clear()
• Count

TrimExcess(Int32)

Source:

Stack.cs

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

C#

public void TrimExcess(int capacity);

Parameters

capacity

Int32

The new capacity.

Exceptions

ArgumentOutOfRangeException

Passed capacity is lower than 0 or entries count.