CKTIS / C++
std::vector::empty — kontrola, či je vektor prázdny
Pomocou `v.empty()` v konštantnom čase zistíš, či vektor neobsahuje žiadne prvky. Rezervovaná kapacita výsledok neovplyvňuje.
Verzia: ISO C++23; implementation support may vary
Syntax
constexpr bool empty() const noexcept;Pripoj hlavičku <vector> a zavolaj v.empty(). std::vector::empty je členská funkcia bez argumentov: vracia true, ak vektor neobsahuje žiadne prvky, inak false. Pracuje v čase O(1), nemení vektor, možno ju volať aj na vektore const a nevyhadzuje výnimky (noexcept od C++11). Od C++20 je constexpr, takže ju možno použiť pri konštantnom vyhodnocovaní, ak celý výraz spĺňa príslušné podmienky.
Výsledok je rovnaký ako pri v.size() == 0 a v.begin() == v.end(). Ak stačí odpoveď áno alebo nie, použi v.empty(); ak potrebuješ počet prvkov, použi v.size(). std::empty(v) (od C++17, <iterator>) je samostatná nečlenská funkcia, ktorá pre vektor volá v.empty().
Úspešné volanie v.reserve(n) zabezpečí kapacitu aspoň n, ale nevytvorí prvky, takže prázdny vektor zostane prázdny. push_back alebo emplace_back pridá prvok; clear() zničí všetky prvky bez zmeny kapacity. Rovnaké pravidlá platia pre std::pmr::vector, ktorý používa iný alokátor.
Pred volaním v.back() alebo v.front() over !v.empty(): na prázdnom vektore majú obe volania v C++23 nedefinované správanie. Nikdy nedereferencuj v.end(); v prázdnom vektore sa mu v.begin() rovná. Ani v neprázdnom vektore nie je platný každý index i: pre v[i] musí byť hodnota i po konverzii na typ size_type daného vektora menšia ako v.size(). Funkcia na výpočet mediánu môže prázdny vstup výslovne odmietnuť vyhodením std::invalid_argument z <stdexcept>; samotná funkcia empty() túto výnimku nevyhadzuje.
Príklady
#include <iostream>
#include <vector>
int main() {
std::vector<int> v;
v.reserve(8);
std::cout << std::boolalpha;
std::cout << "reserve: " << v.empty() << '\n';
v.push_back(42);
if (!v.empty()) {
std::cout << "back: " << v.back() << '\n';
}
v.clear();
std::cout << "clear: " << v.empty() << '\n';
}Výsledok
reserve: true back: 42 clear: true
Po `reserve(8)` zostáva vektor prázdny. Po vložení `42` podmienka umožní zavolať `back()`; po `clear()` vracia `empty()` opäť `true`.
Súvisiace lekcie
- C++ · Lekcia 18 · Pokročilá · Verzia: 3
- C++ · Lekcia 23 · Pokročilá · Verzia: 3
- C++ · Lekcia 30 · Pokročilá · Verzia: 3
Zdroje
- WG21 N4950 — Working Draft, Standard for Programming Language C++ (C++23)
- Class template vector — [vector.overview]
- Container requirements — [container.reqmts]
- Vector capacity — [vector.capacity]
- Sequence containers — [sequence.reqmts]
- Header <vector> synopsis — [vector.syn]
- Range access — [iterator.range]
- Class invalid_argument — [invalid.argument]