CKTIS / C++
std::vector::empty — sprawdzanie, czy wektor jest pusty
Użyj `v.empty()`, aby w stałym czasie sprawdzić, czy wektor nie ma elementów. Zarezerwowana pojemność nie wpływa na wynik.
Wersja: ISO C++23; implementation support may vary
Składnia
constexpr bool empty() const noexcept;Dołącz <vector> i wywołaj v.empty(). std::vector::empty to funkcja składowa bez argumentów: zwraca true, gdy wektor nie ma elementów, i false w przeciwnym razie. Działa w czasie O(1), nie zmienia wektora, można ją wywołać na obiekcie const i nie zgłasza wyjątków (noexcept od C++11). Od C++20 jest constexpr, więc można jej użyć w obliczeniu stałym, jeśli całe wyrażenie spełnia jego wymagania.
Wynik jest taki sam jak dla v.size() == 0 i v.begin() == v.end(). Gdy potrzebujesz tylko odpowiedzi tak lub nie, v.empty() wyraża zamiar wprost; gdy potrzebujesz liczby elementów, użyj v.size(). std::empty(v) (od C++17, <iterator>) to odrębna funkcja nieskładowa, która dla wektora wywołuje v.empty().
v.reserve(n) po pomyślnym zakończeniu zapewnia pojemność co najmniej n, ale nie tworzy elementów, więc pusty wektor pozostaje pusty. push_back lub emplace_back dodaje element, a clear() niszczy wszystkie elementy bez zmiany pojemności. Te same zasady obowiązują dla std::pmr::vector, który używa innego alokatora.
Sprawdź !v.empty() przed v.back() lub v.front(): wywołanie którejkolwiek z tych funkcji dla pustego wektora ma w C++23 niezdefiniowane zachowanie. Nigdy nie dereferencjonuj v.end(); w pustym wektorze v.begin() jest mu równy. Wynik !v.empty() nie oznacza, że dowolny indeks i jest poprawny: dla v[i] wartość i po konwersji na typ size_type wektora musi być mniejsza niż v.size(). Funkcja obliczająca medianę może jawnie odrzucić puste dane wyjątkiem std::invalid_argument z <stdexcept>; samo empty() go nie zgłasza.
Przykłady
#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';
}Wynik
reserve: true back: 42 clear: true
`reserve(8)` pozostawia wektor pusty. Po dodaniu `42` warunek pozwala wywołać `back()`, a po `clear()` test `empty()` znów zwraca `true`.
Powiązane lekcje
- C++ · Lekcja 18 · Zaawansowany · Wersja: 3
- C++ · Lekcja 23 · Zaawansowany · Wersja: 3
- C++ · Lekcja 30 · Zaawansowany · Wersja: 3
Źródła
- 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]