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

CKTIS / C++

std::vector::front — aceder ao primeiro elemento

`front()` acede ao primeiro elemento de um vetor em tempo constante. Se o vetor puder estar vazio, verifica primeiro `empty()`.

Versão: ISO C++23; implementation support may vary

Sintaxe

// Member declarations in std::vector<T, Allocator>, declared in <vector>
constexpr reference front();
constexpr const_reference front() const;

std::vector::front é uma função membro declarada em <vector> que acede ao primeiro elemento sem o remover. Para um vetor não vazio v, v.front() é equivalente a *v.begin() e acede ao mesmo elemento que v[0]. O acesso demora tempo O(1). Ambas as sobrecargas são constexpr desde C++20.

Em C++23, chamar front() num vetor vazio resulta em comportamento indefinido. Não contes com uma exceção nem com um diagnóstico. Se o vetor puder estar vazio, chama front() apenas quando !v.empty() for verdadeiro. Se quiseres que o acesso a um elemento em falta lance uma exceção, usa v.at(0), que lança std::out_of_range quando o vetor está vazio.

Para std::vector<T> com T diferente de bool, a sobrecarga não const devolve T&, pelo que atribuir um valor a v.front() altera o elemento. A sobrecarga const devolve const T&, que não permite alterar o elemento através dessa referência. Para std::vector<bool>, a sobrecarga não const devolve por valor um objeto intermediário que permite alterar o bit, enquanto a sobrecarga const devolve um valor bool.

Guardar uma referência não prolonga o tempo de vida do elemento. Não a uses depois de o elemento ser removido, de o vetor ser destruído ou de a sua memória ser realocada, por exemplo quando push_back() precisa de aumentar a capacidade. Também não guardes uma referência devolvida por front() num vetor temporário para além da expressão completa que criou esse vetor.

Exemplos

#include <iostream>
#include <vector>

void print_first(const std::vector<int>& values)
{
    if (values.empty()) {
        std::cout << "empty\n";
        return;
    }
    std::cout << values.front() << '\n';
}

int main()
{
    std::vector<int> values{7, 9};
    int& first = values.front();
    first = 42;

    print_first(values);
    print_first(std::vector<int>{});
}

Resultado

42
empty

A atribuição através de `first` altera o primeiro elemento para `42`. `print_first` lê-o através da sobrecarga `const` e escreve `empty` para um vetor vazio, sem chamar `front()`.

Lições relacionadas

  • C++ · Lição 28 · Avançado · Versão: 3

Fontes