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

CKTIS / C++

std::vector::size — počet prvků ve vektoru

`size()` vrací aktuální počet prvků v konstantním čase. Platné indexy určuje tento počet, nikoli kapacita zjištěná pomocí `capacity()`.

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

Syntaxe

// Header: <vector>
// Member declaration inside std::vector<T, Allocator> (ISO C++23)
constexpr size_type size() const noexcept;

// Call on a vector v:
auto count = v.size();

std::vector::size je členská funkce bez argumentů deklarovaná v <vector>. Vrací hodnotou počet prvků v rozsahu [v.begin(), v.end()) (u prázdného vektoru nulu). Má konstantní časovou složitost O(1) a lze ji volat i pro vektor const. Od C++11 je noexcept a od C++20 constexpr, takže ji lze použít v konstantním výrazu, pokud to celé vyhodnocení dovoluje. Tento text popisuje ISO C++23; podpora se může lišit podle implementace.

capacity() udává, kolik prvků může vektor pojmout bez realokace. Úspěšné volání reserve(n) zajistí kapacitu pro nejméně n prvků, ale žádný nevytvoří. resize(n) nastaví počet prvků na n a úspěšné volání push_back jej zvýší o jeden. Pokud jen zjišťuješ, zda je vektor prázdný, použij v.empty().

Návratový typ size_type je celočíselný typ bez znaménka, ne nutně std::size_t. Zachovej ho pomocí auto místo převodu na int bez kontroly. Platné indexy splňují 0 <= i < v.size() v matematickém zápisu; nejde o podmínku v C++. Před převodem indexu na size_type odmítni záporné hodnoty i hodnoty větší než maximum tohoto typu. Jinak může i nezáporná hodnota širšího celočíselného typu po převodu dát jiný index, který se vejde do platného rozsahu. v[i] vyžaduje platný index; v.at(i) kontroluje index až po převodu na size_type a vyvolá výjimku std::out_of_range, pokud je převedený index větší nebo roven v.size(). U prázdného vektoru nepočítej v.size() - 1. Potřebuješ-li počet se znaménkem, použij std::ssize(v) z <iterator> (od C++20).

Pokud typ prvku není bool, rozsah [v.data(), v.data() + v.size()) zahrnuje existující prvky; koncový ukazatel nedereferencuj. std::vector<bool> také počítá prvky, ale takový buffer bool* neposkytuje. Uložený počet se při změně vektoru neaktualizuje. Realokace zneplatní ukazatele, reference a iterátory na prvky i původní end(). Přidání prvku na konec zneplatní původní end() i bez realokace.

Příklady

#include <iostream>
#include <vector>

int main() {
    std::vector<int> v;
    const auto before = v.size();

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

    v.push_back(10);
    v.push_back(20);
    std::cout << "after append: " << v.size() << '\n';
    std::cout << "saved size: " << before << '\n';

    v.resize(1);
    std::cout << "after resize: " << v.size() << '\n';
}

Výsledek

after reserve: 0
after append: 2
saved size: 0
after resize: 1

Po `reserve(8)` je vektor stále prázdný. Dvě volání `push_back` zvýší velikost na 2, ale `before` zůstane 0. `resize(1)` odstraní poslední prvek. Program nepředpokládá žádnou přesnou kapacitu.

Související lekce

  • C++ · Lekce 11 · Pokročilá · Verze: 3
  • C++ · Lekce 14 · Pokročilá · Verze: 3
  • C++ · Lekce 15 · Pokročilá · Verze: 3
  • C++ · Lekce 18 · Pokročilá · Verze: 3
  • C++ · Lekce 23 · Pokročilá · Verze: 3
  • C++ · Lekce 24 · Pokročilá · Verze: 3
  • C++ · Lekce 27 · Pokročilá · Verze: 3
  • C++ · Lekce 29 · Pokročilá · Verze: 3
  • C++ · Lekce 30 · Pokročilá · Verze: 3
  • C++ · Lekce 32 · Pokročilá · Verze: 3
  • C++ · Lekce 34 · Pokročilá · Verze: 3
  • C++ · Lekce 51 · Pokročilá · Verze: 3
  • C++ · Lekce 54 · Pokročilá · Verze: 3
  • C++ · Lekce 57 · Pokročilá · Verze: 3
  • C++ · Lekce 58 · Pokročilá · Verze: 3
  • C++ · Lekce 59 · Pokročilá · Verze: 3

Zdroje