CKTIS / C++
std::vector::size — počet prvkov vo vektore
`size()` vracia aktuálny počet prvkov v konštantnom čase. Platné indexy určuje tento počet, nie kapacita zistená pomocou `capacity()`.
Verzia: ISO C++23; implementation support may vary
Syntax
// 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á funkcia bez argumentov deklarovaná v <vector>. Vracia hodnotou počet prvkov v rozsahu [v.begin(), v.end()) (pri prázdnom vektore nulu). Má konštantnú časovú zložitosť O(1) a dá sa volať aj na vektore const. Od C++11 je noexcept a od C++20 constexpr, takže ju možno použiť v konštantnom výraze, pokiaľ to celé vyhodnotenie umožňuje. Tento text opisuje ISO C++23; podpora sa môže líšiť podľa implementácie.
capacity() udáva, koľko prvkov sa do vektora zmestí bez realokácie. Úspešné volanie reserve(n) zaistí kapacitu aspoň pre n prvkov, ale žiadny nevytvorí. resize(n) nastaví počet prvkov na n a úspešné volanie push_back ho zvýši o jeden. Ak len zisťuješ, či je vektor prázdny, použi v.empty().
Návratový typ size_type je celočíselný typ bez znamienka, nie nevyhnutne std::size_t. Zachovaj ho pomocou auto namiesto konverzie na int bez kontroly. Platné indexy spĺňajú 0 <= i < v.size() v matematickom zápise; nejde o podmienku v C++. Pred konverziou indexu na size_type odmietni záporné hodnoty aj hodnoty väčšie než maximum tohto typu. Inak môže aj nezáporná hodnota zo širšieho celočíselného typu po konverzii dať iný index, ktorý sa zmestí do platného rozsahu. v[i] vyžaduje platný index; v.at(i) kontroluje index až po konverzii na size_type a vyvolá výnimku std::out_of_range, ak je skonvertovaný index väčší alebo rovný v.size(). Pre prázdny vektor nepočítaj v.size() - 1. Ak potrebuješ počet so znamienkom, použi std::ssize(v) z <iterator> (od C++20).
Ak typ prvku nie je bool, rozsah [v.data(), v.data() + v.size()) zahŕňa existujúce prvky; koncový ukazovateľ nedereferencuj. std::vector<bool> tiež počíta prvky, ale takýto buffer bool* nesprístupňuje. Uložený počet sa pri zmene vektora neaktualizuje. Realokácia zneplatní ukazovatele, referencie a iterátory na prvky aj pôvodný end(). Pridanie prvku na koniec zneplatní pôvodný end() aj bez realokácie.
Prí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ýsledok
after reserve: 0 after append: 2 saved size: 0 after resize: 1
Po `reserve(8)` je vektor stále prázdny. Dve volania `push_back` zvýšia veľkosť na 2, ale `before` zostane 0. `resize(1)` odstráni posledný prvok. Program nepredpokladá žiadnu presnú kapacitu.
Súvisiace lekcie
- C++ · Lekcia 11 · Pokročilá · Verzia: 3
- C++ · Lekcia 14 · Pokročilá · Verzia: 3
- C++ · Lekcia 15 · Pokročilá · Verzia: 3
- C++ · Lekcia 18 · Pokročilá · Verzia: 3
- C++ · Lekcia 23 · Pokročilá · Verzia: 3
- C++ · Lekcia 24 · Pokročilá · Verzia: 3
- C++ · Lekcia 27 · Pokročilá · Verzia: 3
- C++ · Lekcia 29 · Pokročilá · Verzia: 3
- C++ · Lekcia 30 · Pokročilá · Verzia: 3
- C++ · Lekcia 32 · Pokročilá · Verzia: 3
- C++ · Lekcia 34 · Pokročilá · Verzia: 3
- C++ · Lekcia 51 · Pokročilá · Verzia: 3
- C++ · Lekcia 54 · Pokročilá · Verzia: 3
- C++ · Lekcia 57 · Pokročilá · Verzia: 3
- C++ · Lekcia 58 · Pokročilá · Verzia: 3
- C++ · Lekcia 59 · Pokročilá · Verzia: 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]