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

CKTIS / C++

std::array: contentor de tamanho fixo

std::array é um contentor contíguo cujo número de elementos é conhecido na compilação. Não aloca um buffer dinâmico separado.

Versão: C++23

Sintaxe

template<class T, std::size_t N>
struct array {
    constexpr iterator begin() noexcept;
    constexpr const_iterator begin() const noexcept;
    constexpr iterator end() noexcept;
    constexpr const_iterator end() const noexcept;
    constexpr size_type size() const noexcept;
};

std::array<T, N> values{elements...};

std::array<T, N>, de <array>, fornece uma interface de contentor a um array nativo. É um agregado contíguo e N faz parte do tipo. Pode ser copiado por valor, comparado e usado com algoritmos.

Uma inicialização agregada como {1, 2} inicializa os elementos restantes a partir de uma lista vazia quando N é maior. Isso produz zero para int e outros tipos aritméticos; para um T geral aplicam-se as suas próprias regras, incluindo inicializadores predefinidos de membros de um agregado. at() verifica limites e lança std::out_of_range; operator[] não verifica. fill atribui o mesmo valor a todos.

std::array::begin devolve o iterador para o primeiro elemento, std::array::end o iterador após o fim e std::array::size devolve sempre a quantidade constante N; as sobrecargas de um objeto const devolvem iteradores só de leitura. Com N == 0, o intervalo está vazio e begin() == end(). Chamar front() ou back() é indefinido. Não existem inserções que alterem o tamanho; usa std::vector para tamanho em execução.

Exemplos

#include <array>
#include <iostream>

int main() {
    const std::array<int, 3> values{2, 3, 4};
    std::cout << values.at(1) << ' ' << values.size() << '\n';
}

Resultado

3 3

std::array → 3 3

Fontes