Stack<T>.TrimExcess Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
TrimExcess() |
Nastaví kapacitu na skutečný počet prvků v Stack<T>, pokud je toto číslo menší než 90 procent aktuální kapacity. |
TrimExcess(Int32) |
Nastaví kapacitu objektu Stack<T> na zadaný počet položek. |
TrimExcess()
- Zdroj:
- Stack.cs
- Zdroj:
- Stack.cs
- Zdroj:
- Stack.cs
Nastaví kapacitu na skutečný počet prvků v Stack<T>, pokud je toto číslo menší než 90 procent aktuální kapacity.
public:
void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()
Poznámky
Tuto metodu lze použít k minimalizaci režie paměti kolekce, pokud do kolekce nebudou přidány žádné nové prvky. Náklady na přemístění a kopírování velkých Stack<T> však mohou být značné, takže metoda TrimExcess nic nedělá, pokud je seznam větší než 90 procent kapacity. Tím se zabrání vzniku velkých nákladů na relokaci za relativně malý zisk.
Tato metoda je operace O(n
), kde n
je Count.
Chcete-li obnovit Stack<T> do počátečního stavu, před voláním metody TrimExcess zavolejte metodu Clear. Oříznutí prázdné Stack<T> nastaví kapacitu Stack<T> na výchozí kapacitu.
Viz také
Platí pro
TrimExcess(Int32)
- Zdroj:
- Stack.cs
Nastaví kapacitu objektu Stack<T> na zadaný počet položek.
public:
void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)
Parametry
- capacity
- Int32
Nová kapacita.
Výjimky
Počet předaných položek je nižší než 0 nebo počet položek.