CKTIS / C++
std::vector::empty — comprobar si un vector está vacío
Usa `v.empty()` para comprobar en tiempo constante si un vector no tiene elementos. La capacidad reservada no cambia el resultado.
Versión: ISO C++23; implementation support may vary
Sintaxis
constexpr bool empty() const noexcept;Incluye <vector> y llama a v.empty(). std::vector::empty es una función miembro sin argumentos: devuelve true si el vector no contiene elementos y false en caso contrario. Se ejecuta en O(1), no modifica el vector, puede llamarse sobre un vector const y no lanza excepciones (noexcept desde C++11). Es constexpr desde C++20 y puede usarse en una evaluación constante si la expresión completa cumple los requisitos.
El resultado equivale a v.size() == 0 y a v.begin() == v.end(). Prefiere v.empty() cuando solo necesites una respuesta afirmativa o negativa; usa v.size() para obtener el número de elementos. std::empty(v) (desde C++17, <iterator>) es una función no miembro distinta que llama a v.empty() para un vector.
Una llamada exitosa a v.reserve(n) garantiza una capacidad de al menos n sin crear elementos, así que un vector vacío sigue vacío. push_back o emplace_back añade un elemento; clear() destruye todos los elementos sin cambiar la capacidad. Las mismas reglas se aplican a std::pmr::vector, que usa un asignador diferente.
Comprueba !v.empty() antes de llamar a v.back() o v.front(): llamarlas en un vector vacío tiene comportamiento indefinido en C++23. Nunca desreferencies v.end(); en un vector vacío, v.begin() es igual a v.end(). Que el vector no esté vacío no hace válido cualquier índice i: para v[i], el valor de i tras la conversión al tipo size_type del vector debe ser menor que v.size(). Una función que calcule la mediana puede rechazar explícitamente una entrada vacía lanzando std::invalid_argument de <stdexcept>; empty() no lanza esa excepción.
Ejemplos
#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';
}Resultado
reserve: true back: 42 clear: true
`reserve(8)` deja el vector vacío. Tras insertar `42`, la comprobación permite llamar a `back()`; después de `clear()`, `empty()` vuelve a devolver `true`.
Lecciones relacionadas
- C++ · Lección 18 · Avanzado · Versión: 3
- C++ · Lección 23 · Avanzado · Versión: 3
- C++ · Lección 30 · Avanzado · Versión: 3
Fuentes
- 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]