CircularSortedListTKey, TValueTrimExcess Method

Sets the capacity to the actual number of elements in the CircularSortedListTKey, TValue, if that number is less than 90 percent of current capacity.

Definition

Namespace: KGySoft.Collections
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 8.1.0
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 CircularSortedListTKey, TValue 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 CircularSortedListTKey, TValue to its initial state, call the Reset method. Calling the Clear and TrimExcess methods has the same effect; however, Reset method is an O(1) operation, while Clear> is an O(n) operation. Trimming an empty CircularSortedListTKey, TValue sets the capacity of the list to 0.

The capacity can also be set using the Capacity property.

See Also