std::vector::reserve

 

C++

Jazyk

Standardní hlavičkové soubory

Koncepty

Knihovna utilit

Knihovna řetězců

Knihovna kontejnerů

Knihovna algoritmů

Knihovna iterátorů

Knihovna numeriky

Knihovna vstupů/výstupů

Knihovna lokalizace

Knihovna regulárních výrazů (C++11)

Knihovna atomických operací (C++11)

Knihovna pro podporu vláken (C++11)

 

Knihovna kontejnerů

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

Členské funkce

vector::vector

vector::~vector

vector::operator=

vector::assign

vector::get_allocator

Přístup k prvkům

vector::at

vector::operator[]

vector::front

vector::back

vector::data (C++11)

Iterátory

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

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

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

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

Kapacita

vector::empty

vector::size

vector::max_size

vector::reserve

vector::capacity

vector::shrink_to_fit (C++11)

Změna obsahu

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 reserve( size_type new_cap );

Zvětší kapacitu kontejneru na hodnoty větší nebo rovnu new_cap. Je-li new_cap větší než současná hodnota capacity(), je alokována nová paměť, v opačném případě metoda nic nedělá.

Je-li new_cap větší než capacity(), všechny iterátory a reference, včetně koncového iterátoru, jsou zneplatněny. V opačném případně nejsou zneplatněny žádné iterátory ani reference.

Parametry

new_cap	-	nová kapacita kontejneru
Požadavky kladené na typ
- T musí splňovat požadavky konceptu MoveInsertable.

Návratová hodnota

(žádná)

Výjimky

std::length_error jestliže new_cap > max_size().

Asymptotická časová složitost

Nejvýše lineární s počtem prvků size() v kontejneru.

Poznámky

Metodou reserve() se kapacita kontejneru nedá snížit. Pro tento účel složí metoda shrink_to_fit().

Viz také

capacity	vrátí počet prvků, kolik se vejde do současného alokovaného místa (veřejná členská funkce)
resize	přenastaví počet prvků (veřejná členská funkce)
shrink_to_fit (C++11)	požádá o uvolnění nevyužité paměti (veřejná členská funkce)