dictionary.TrimExcess

定義¶

名前空間: Alice
アセンブリ: Losetta.Runtime.dll
ソースコード: Alice.Core.Dictionary.cs

TrimExcess(number)¶

辞書の容量を指定した値にします

class Alice.Dictionary;
public void TrimExcess(number capacity);

TrimExcess()¶

辞書の容量を現在辞書内に存在する項目の数と同じまで減らします

class Alice.Dictionary;
public void TrimExcess();

説明¶

このメソッドは、辞書の容量をcapacityに設定します。capacityはLengthの値と同じか、大きい必要があります。capacityが現在辞書に存在する項目の数よりも少ない場合は、例外が発生します。

このメソッドはEnsureCapacityメソッドとは異なり、辞書の現在の容量に関わらず容量をcapacityに設定します。もし、指定した値以上の容量があれば良く、それを確認する必要がある場合にはEnsureCapacityメソッドを使用してください。

容量の拡張が必要な場合、このメソッドは現在の容量と新しく指定したcapacityの値の和を格納できるだけのメモリを確保します。このため、このメソッドの操作は負荷の大きな作業です。このメソッドを使用すると、新しい要素が追加されないことがわかっている場合に、メモリ使用を最小限に抑えることができます。

辞書に割り当てられているメモリできるだけ解放するには、次のようにします。

dict.Clear();
dict.TrimExcess();

例¶

以下は、辞書の容量を5に設定します。

dictionary dict = { 
    "one": 1,
    "two": 2
};

dict.TrimExcess(5);