Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

resize a reserve u std::vector a std::basic_string

`resize` mění počet existujících prvků, zatímco `reserve` připravuje místo pro další prvky, aniž by měnilo aktuální velikost nebo obsah.

Verze: ISO C++23; implementation support may vary

Syntaxe

// Selected ISO C++23 member declarations, grouped by owning class.
// std::vector<T, Allocator> — <vector>
constexpr void reserve(size_type n);
constexpr void resize(size_type n);
constexpr void resize(size_type n, const T& value);

// std::basic_string<CharT, Traits, Allocator> — <string>
constexpr void reserve(size_type n);
constexpr void resize(size_type n);
constexpr void resize(size_type n, CharT ch);

V C++23 rozlišují std::vector a std::basic_string velikost (size()) a kapacitu (capacity()). reserve(n) nemění velikost ani obsah. Pokud n > capacity(), dojde k realokaci a nová kapacita bude nejméně n; jinak se kapacita nezmění. Rezervované místo nerozšiřuje rozsah přístupných prvků. Bezargumentové přetížení std::basic_string::reserve() je v C++23 zastaralé; std::vector takové přetížení nemá.

Po úspěšném volání resize(n) nebo resize(n, value) je velikost přesně n. Zmenšení odstraní prvky na konci; požadavek na stávající velikost obsah nezmění. Při zvětšení std::vector::resize(n) přidá implicitně vkládané prvky podle pravidel alokátoru (nuly u std::vector<int> se standardním alokátorem). Přetížení se dvěma argumenty přidá kopie value, aniž by nahradilo stávající prvky.

U std::basic_string přidává přetížení s jedním argumentem hodnoty CharT() ('\0' pro std::string), zatímco přetížení se dvěma argumenty přidává zadaný znak. Přidané nulové znaky se započítávají do size(), ale funkce očekávající řetězec ve stylu C končí u prvního nulového znaku. V textu UTF-8 počítá std::string bajty, nikoli viditelné znaky; zkrácení může rozdělit vícebajtovou sekvenci.

Realokace vektoru zneplatní všechny ukazatele, reference a iterátory na jeho prvky i původní end(). Nepoužívej ty, které odkazovaly na odstraněné prvky. U řetězce je resize může zneplatnit i při nezměněné kapacitě. Zmenšení velikosti nezaručuje uvolnění paměti. Pro oba typy vyvolá reserve(n) výjimku std::length_error, pokud n > max_size(); totéž platí pro resize(n) u řetězce. Výjimku může vyvolat i alokace nebo konstrukce prvků vektoru.

Příklady

#include <iostream>
#include <string>
#include <vector>

int main() {
    std::vector<int> v{10, 20};
    std::string s = "ab";

    v.reserve(8);
    s.reserve(8);
    std::cout << "reserve: " << v.size() << ' ' << s.size() << '\n';

    v.resize(3);
    s.resize(3);
    std::cout << "default: " << v.back() << ' ' << (s.back() == '\0') << '\n';

    v.resize(5, 7);
    s.resize(5, '*');
    std::cout << "fill: " << v.back() << ' ' << s.back() << '\n';

    v.resize(1);
    s.resize(1);
    std::cout << "shrink: " << v.size() << ' ' << s.size()
              << " | " << v.front() << ' ' << s << '\n';
}

Výsledek

reserve: 2 2
default: 0 1
fill: 7 *
shrink: 1 1 | 10 a

Po rezervaci mají oba objekty stále velikost 2. Na řádku `default` znamená `1`, že poslední znak je `'\0'`. Následující řádky ukazují vyplnění zadanými hodnotami a zkrácení na jeden prvek.

Související lekce

  • C++ · Lekce 5 · Pokročilá · Verze: 3

Zdroje