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
- C++ working draft — Class template vector [vector]
- C++ working draft — Container requirements [container.reqmts]
- C++ working draft — Sequence containers [sequence.reqmts]
- C++ working draft — Vector capacity [vector.capacity]
- C++ working draft — Vector data [vector.data]
- C++ working draft — Vector modifiers [vector.modifiers]
- C++ working draft — Specialization of vector for bool [vector.bool]
- C++ working draft — Range access [iterator.range]