std::array - cppreference.com

De cppreference.com

Definido no cabeçalho `<array>`

`template< class T, std::size_t N > struct array;`		(desde C++11)

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.

Tipos membro


Tipo de membro Original: Member type The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.	Definition

`value_type`	`T` [edit]

`size_type`	`size_t` [edit]

`difference_type`	`ptrdiff_t` [edit]

`reference`	`value_type&` [edit]

`const_reference`	`const value_type&` [edit]

`pointer`	`T*`[edit]

`const_pointer`	`const T*`[edit]

`iterator`	`RandomAccessIterator` [edit]

`const_iterator`	Iterador constante acesso aleatório Original: Constant random access iterator The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. [edit]

`reverse_iterator`	`std::reverse_iterator<iterator>` [edit]

`const_reverse_iterator`	`std::reverse_iterator<const_iterator>` [edit]

Funções membro

acesso. Elemento Original: Element access The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

at	acessar o elemento especificado com verificação de limites Original: access specified element with bounds checking The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

operator[]	acessar o elemento especificado Original: access specified element The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

front	acesso ao primeiro elemento Original: access the first element The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

back	access the last element (função pública membro) [edit]

data (C++11)	acesso directo para a matriz subjacente Original: direct access to the underlying array The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]
Iteradores Original: Iterators The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

begin cbegin	retorna um iterador para o começo Original: returns an iterator to the beginning The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

end cend	retorna um iterador para o fim Original: returns an iterator to the end The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

rbegin crbegin	retorna um iterador inverso ao início Original: returns a reverse iterator to the beginning The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

rend crend	retorna um iterador inverso até ao fim Original: returns a reverse iterator to the end The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]
Capacidade Original: Capacity The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

empty	verifica se o recipiente estiver vazio Original: checks whether the container is empty The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

size	devolve o número de elementos Original: returns the number of elements The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

max_size	retorna o número máximo possível de elementos Original: returns the maximum possible number of elements The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]
Operações Original: Operations The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

fill	encher o recipiente com o valor especificado Original: fill the container with specified value The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

swap	Trocar o conteúdo Original: swaps the contents The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]

Não-membros funções


operator== operator!= operator< operator<= operator> operator>=	lexicographically compara os valores na array Original: lexicographically compares the values in the array The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (modelo de função) [edit]

std::get(std::array)	accesses an element of an `array` (modelo de função) [edit]

std::swap(std::array)	o algoritmo especializado std::swap Original: specializes the std::swap algorithm The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (modelo de função) [edit]

Classes auxiliares


	obtém o tamanho de um `array` Original: obtains the size of an `array` The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (especialização modelo. classe) [edit]

	obtém o tipo dos elementos de `array` Original: obtains the type of the elements of `array` The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (especialização modelo. classe) [edit]

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 << ' ';
}

Saída:

std::array - cppreference.com

Tipos membro

Funções membro

acesso. ElementoOriginal: Element accessThe text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

IteradoresOriginal: IteratorsThe text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

CapacidadeOriginal: CapacityThe text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

OperaçõesOriginal: OperationsThe text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Não-membros funções

Classes auxiliares

Exemplo

acesso. Elemento
Original:
Element access
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Iteradores
Original:
Iterators
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Capacidade
Original:
Capacity
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Operações
Original:
Operations
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.