std::vector::shrink_to_fit

 

C++

Język

Nagłówki biblioteki standardowej

Koncepty

Biblioteka narzędzi

Biblioteka string

Biblioteka kontenerów

Biblioteka algorytmów

Biblioteka iteratorów

Biblioteka numeryczna

Biblioteka wejścia/wyjścia

Biblioteka lokalizacji

Biblioteka wyrażeń regularnych (C++11)

Biblioteka operacji atomowych (C++11)

Biblioteka obsługi wątków (C++11)

 

Kontenery

array (C++11)

vector

deque

forward_list (C++11)

list

set

multiset

map

multimap

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

stack

queue

priority_queue

 

std::vector

Metody

vector::vector

vector::~vector

vector::operator=

vector::assign

vector::get_allocator

Dostęp do elementów

vector::at

vector::operator[]

vector::front

vector::back

vector::data (C++11)

Iteratory

vector::beginvector::cbegin (C++11)

vector::endvector::cend (C++11)

vector::rbeginvector::crbegin (C++11)

vector::rendvector::crend (C++11)

Pojemność

vector::empty

vector::size

vector::max_size

vector::reserve

vector::capacity

vector::shrink_to_fit (C++11)

Modyfikatory

vector::clear

vector::insert

vector::emplace (C++11)

vector::erase

vector::push_back

vector::emplace_back (C++11)

vector::pop_back

vector::resize

vector::swap

 

<tbody> </tbody>

void shrink_to_fit();		(od C++11)

Zgłasza rządanie o zwolnienie niewykorzystywanej pojemności.

Jest to niewiążące żądanie, aby zmniejszyć pojemność (capacity()) do obecnego rozmiaru kontenera (size()). To, czy to żądanie zostanie rzeczywiście wykonane, zależy od implementacji.

Jeśli następuje realokacja, wszystkie referencje i iteratory, wliczając iterator zakońcowy zostają unieważnione. W przeciwnym wypadku, żadne referencje ani iteratory nie zostają unieważnione.

Parametry

(brak)

Wymagania względem typów

- T musi spełniać wymagania MoveInsertable.

Zwracana wartość

(brak)

Złożoność

Co najwyżej liniowa względem rozmiaru kontenera.

Notka

Jeśli zostanie wyrzucony wyjątek (i nie będzie to wyjątek wyrzucony przez konstruktor przenoszący T), metoda nie zmieni zawartości kontenera.

Przykład

#include <iostream>
#include <vector>

int main()
{
    std::vector<int> v;
    std::cout << "Default-constructed capacity is " << v.capacity() << '\n';
    v.resize(100);
    std::cout << "Capacity of a 100-element vector is " << v.capacity() << '\n';
    v.clear();
    std::cout << "Capacity after clear() is " << v.capacity() << '\n';
    v.shrink_to_fit();
    std::cout << "Capacity after shrink_to_fit() is " << v.capacity() << '\n';
}

Możliwy wynik:

Default-constructed capacity is 0
Capacity of a 100-element vector is 100
Capacity after clear() is 100
Capacity after shrink_to_fit() is 0

Zobacz także

size	zwraca liczbę elementów (publiczna metoda)
capacity	zwraca liczbę elementów, które mogą być przechowane w obecnie zarezerwowanej pamięci (publiczna metoda)