Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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