std::array

This page has been machine-translated from the English version of the wiki using Google Translate. The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here. Click here for the English version of this page

std::array é um contêiner que encapsula um array de tamanho constante.

Esta estrutura possui a mesma semântica de tipo agregado que o array estilo C. O tamanho e a eficiência do array<T,N>, para uma certa quantidade de elementos, são equivalentes ao array T[N] estilo C correspondente. A estrutura provê os benefícios de um contêiner padrão, tais como o próprio tamanho, suporte a atribuição, acesso randômico, iteradores, etc.

Há um caso especial para array de tamanho zero ((N == 0)). Nesse caso, array.begin() == array.end(), que é algum valor único. O efeito de chamar front() or back() ou back() em um array de tamanho zero é indefinido.

array é um agregado (não possui construtores nem membros privados ou protegidos), o que o permite usar aggregate-initialization.

Um array também pode ser usado como uma tupla de N elementos do mesmo tipo.

[editar] Tipos membro

[editar] Funções membro

[editar] Não-membros funções

[editar] Classes auxiliares

[editar] Exemplo

#include <string>
#include <iterator>
#include <iostream>
#include <algorithm>
#include <array>
 
int main()
{
    // construction uses aggregate initialization
    std::array<int, 3> a1{ {1,2,3} };    // double-braces required
    std::array<int, 3> a2 = {1, 2, 3}; // except after =
    std::array<std::string, 2> a3 = { {std::string("a"), "b"} };
 
    // container operations are supported
    std::sort(a1.begin(), a1.end());
    std::reverse_copy(a2.begin(), a2.end(), std::ostream_iterator<int>(std::cout, " "));
 
    // ranged for loop is supported
    for(auto& s: a3)
        std::cout << s << ' ';
}

3 2 1 a b