KGy SOFT

CacheTKey, TValue Constructor (Int32, IEqualityComparerTKey)

KGy SOFT Core Libraries Help

Namespace:  KGySoft.Collections
Assembly:  KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 5.0.0
Syntax

public Cache(
	int capacity,
	IEqualityComparer<TKey> comparer = null
)

Parameters

capacity
Type: SystemInt32
Capacity of the CacheTKey, TValue (possible maximum value of Count)
comparer (Optional)
Type: System.Collections.GenericIEqualityComparerTKey
The IEqualityComparerT implementation to use when comparing keys. When , EnumComparer<TEnum>.Comparer will be used for enum key types, and EqualityComparer<T>.Default for other types. This parameter is optional.
Default value: .
Remarks

Every key in a CacheTKey, TValue must be unique according to the specified comparer.

The capacity of a CacheTKey, TValue is the maximum number of elements that the CacheTKey, TValue can hold. When EnsureCapacity is , the internal store is allocated when the first element is added to the cache. When EnsureCapacity is , then as elements are added to the CacheTKey, TValue, the inner storage is automatically increased as required until Capacity is reached or exceeded. When EnsureCapacity is turned on while there are elements in the CacheTKey, TValue, then internal storage will be reallocated to have exactly the same size that Capacity defines. The possible exceeding storage will be trimmed in this case.

When CacheTKey, TValue is full (that is, when Count reaches Capacity) and a new element is about to be stored, then an element will be dropped out from the cache. The strategy is controlled by Behavior property.

This constructor does not specify an item loader so you have to add elements manually to this CacheTKey, TValue instance. In this case the CacheTKey, TValue can be used similarly to a DictionaryTKey, TValue: before getting an element, its existence must be checked by ContainsKey or TryGetValue methods, though Capacity is still maintained based on the strategy specified in the Behavior property.

See Also

Reference