CKTIS / C++
std::vector::empty — provjera je li vektor prazan
Pomoću `v.empty()` u konstantnom vremenu provjeri ima li vektor nula elemenata. Rezervirani kapacitet ne utječe na rezultat.
Verzija: ISO C++23; implementation support may vary
Sintaksa
constexpr bool empty() const noexcept;Uključi <vector> i pozovi v.empty(). std::vector::empty članska je funkcija bez argumenata: vraća true ako vektor nema elemenata, a inače false. Radi u vremenu O(1), ne mijenja vektor, može se pozvati i na vektoru const te ne baca iznimke (noexcept od C++11). Od C++20 je constexpr, pa se može koristiti pri konstantnom vrednovanju ako cijeli izraz zadovoljava uvjete.
Rezultat je jednak onome izraza v.size() == 0 i v.begin() == v.end(). Ako ti treba samo odgovor da ili ne, upotrijebi v.empty(); ako trebaš broj elemenata, upotrijebi v.size(). std::empty(v) (od C++17, <iterator>) zasebna je nečlanska funkcija koja za vektor poziva v.empty().
Uspješan poziv v.reserve(n) osigurava kapacitet od najmanje n, ali ne stvara elemente, pa prazan vektor ostaje prazan. push_back ili emplace_back dodaje element; clear() uništava sve elemente bez promjene kapaciteta. Ista pravila vrijede za std::pmr::vector, koji koristi drugi alokator.
Provjeri !v.empty() prije poziva v.back() ili v.front(): oba poziva na praznom vektoru imaju nedefinirano ponašanje u C++23. Nikada nemoj dereferencirati v.end(); u praznom vektoru v.begin() mu je jednak. Ni u nepraznom vektoru nije svaki indeks i valjan: za v[i] vrijednost i nakon pretvorbe u tip size_type vektora mora biti manja od v.size(). Funkcija za izračun medijana može izričito odbiti prazan ulaz bacanjem iznimke std::invalid_argument iz <stdexcept>; sam empty() ne baca tu iznimku.
Primjeri
#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';
}Rezultat
reserve: true back: 42 clear: true
Nakon `reserve(8)` vektor ostaje prazan. Nakon umetanja `42` provjera dopušta poziv `back()`; nakon `clear()` funkcija `empty()` ponovno vraća `true`.
Povezane lekcije
- C++ · Lekcija 18 · Napredno · Verzija: 3
- C++ · Lekcija 23 · Napredno · Verzija: 3
- C++ · Lekcija 30 · Napredno · Verzija: 3
Izvori
- 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]