CKTIS / C++
std::vector::empty — verificar se um vetor está vazio
Usa `v.empty()` para verificar em tempo constante se um vetor não tem elementos. A capacidade reservada não altera o resultado.
Versão: ISO C++23; implementation support may vary
Sintaxe
constexpr bool empty() const noexcept;Inclui <vector> e chama v.empty(). std::vector::empty é uma função membro sem argumentos: devolve true se o vetor não contiver elementos e false caso contrário. Executa-se em tempo O(1), não modifica o vetor, pode ser chamada sobre um vetor const e não lança exceções (noexcept desde C++11). É constexpr desde C++20 e pode ser usada numa avaliação constante se a expressão completa cumprir os requisitos.
O resultado é equivalente a v.size() == 0 e a v.begin() == v.end(). Prefere v.empty() quando só precisas de uma resposta de sim ou não; usa v.size() para obter o número de elementos. std::empty(v) (desde C++17, <iterator>) é uma função não membro distinta que, para um vetor, chama v.empty().
Uma chamada bem-sucedida a v.reserve(n) garante uma capacidade de pelo menos n, mas não cria elementos. Um vetor vazio continua, portanto, vazio. push_back ou emplace_back acrescenta um elemento; clear() destrói todos os elementos sem alterar a capacidade. As mesmas regras aplicam-se a std::pmr::vector, que usa um alocador diferente.
Verifica !v.empty() antes de chamar v.back() ou v.front(): sobre um vetor vazio, ambas as chamadas têm comportamento indefinido em C++23. Nunca desreferencies v.end(); num vetor vazio, v.begin() é igual a v.end(). Um vetor não vazio não torna válido qualquer índice i: para v[i], o valor de i após a conversão para o tipo size_type do vetor tem de ser inferior a v.size(). Uma função que calcule a mediana pode rejeitar explicitamente uma entrada vazia lançando std::invalid_argument de <stdexcept>; empty() não lança essa exceção.
Exemplos
#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)` deixa o vetor vazio. Depois de inserir `42`, a verificação permite chamar `back()`; depois de `clear()`, `empty()` volta a devolver `true`.
Lições relacionadas
- C++ · Lição 18 · Avançado · Versão: 3
- C++ · Lição 23 · Avançado · Versão: 3
- C++ · Lição 30 · Avançado · Versão: 3
Fontes
- 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]