CKTIS / C++
O declarador de arrays (`[]`) em C++
O declarador `[]` forma um tipo array nativo. O número de elementos pode fazer parte do tipo, mas a notação de array num parâmetro não transmite esse número.
Versão: ISO C++23; implementation support may vary
Sintaxe
T a[N]; // array of N elements of type T
T a[] = {v1, v2}; // bound inferred as 2 in this definition
extern T a[]; // unknown bound if no prior declaration supplies it
T grid[R][C]; // R elements, each an array of C elements
T* slots[N]; // array of N pointers to T
T (*p)[N] = &a; // pointer to the whole array
T (&r)[N] = a; // lvalue reference to the whole array
void f(const T a[N]); // adjusted to void f(const T* a)Em T a[N], o declarador [] declara N elementos contíguos do tipo T. Um N explícito tem de ser uma expressão constante convertida de tipo std::size_t, com valor superior a zero. Neste declarador, os arrays de tamanho determinado em tempo de execução são uma extensão do compilador, não uma funcionalidade de ISO C++23. Na expressão a[i], os parênteses retos indicam acesso por índice, não uma declaração. Aceder fora do intervalo de índices de 0 a N - 1 tem comportamento indefinido.
Em int a[]{1, 2}, o inicializador determina o número de elementos. Em contrapartida, extern int a[];, sem uma declaração anterior que indique o tamanho, declara um tipo array incompleto ao qual não se pode aplicar sizeof. Um char buf[32]; local com duração de armazenamento automática deixa os elementos por inicializar: escreve-os antes de os ler. Em char buf[32]{};, a inicialização de agregado atribui o valor zero a cada elemento. Um membro char label[8]; é armazenado no próprio objeto; se for usado como cadeia de caracteres de C, um elemento tem de conter o \0 final.
Em T* slots[N], os elementos são ponteiros; em T (*p)[N], p aponta para um array inteiro. T (&r)[N] é uma referência lvalue a um array inteiro. Em T* p = a;, o array é convertido implicitamente num ponteiro para o primeiro elemento, sem informação sobre o comprimento. Para um array de tipo completo, sizeof a dá o tamanho em bytes do array inteiro. Em T grid[R][C], o primeiro elemento é uma linha de tipo T[C], pelo que a conversão produz T (*)[C], não T**.
Numa declaração de parâmetro, void f(const T a[N]); é ajustado para void f(const T* a);. As duas formas declaram a mesma função, não duas sobrecargas; N não exige um comprimento mínimo e const aplica-se aos elementos. Esta regra é distinta da conversão do argumento no local da chamada. Passa o ponteiro juntamente com uma contagem válida dos elementos acessíveis ou usa um parâmetro de tipo referência para array, para manter o tamanho no tipo. Não acedas aos elementos através desse ponteiro ou referência depois de terminar o tempo de vida do array.
Exemplos
#include <cstddef>
#include <iostream>
#include <type_traits>
struct Record {
char label[8];
int value;
};
int sum(const Record items[2], std::size_t count) {
static_assert(std::is_same_v<decltype(items), const Record*>);
int total = 0;
for (std::size_t i = 0; i < count; ++i) {
total += items[i].value;
}
return total;
}
template <std::size_t N>
constexpr std::size_t extent(const Record (&)[N]) {
return N;
}
int main() {
const Record records[]{{"A", 3}, {"B", 4}};
char32_t buffer[4]{};
const auto count = extent(records);
std::cout << count << ' ' << sum(records, count) << ' '
<< (buffer[0] == U'\0') << '\n';
}
Resultado
2 7 1
`extent` deduz o número de registos a partir do tipo do array. `sum` recebe um ponteiro e uma contagem em separado. A saída `2 7 1` indica dois registos, uma soma de 7 e que o primeiro elemento de `buffer` é igual ao carácter nulo.
Lições relacionadas
- C++ · Lição 47 · Avançado · Versão: 3
- C++ · Lição 53 · Avançado · Versão: 3
- C++ · Lição 56 · Avançado · Versão: 3
- C++ · Lição 58 · Avançado · Versão: 3
Fontes
- Arrays [dcl.array]
- Aggregate initialization [dcl.init.aggr]
- Initializers: General [dcl.init.general]
- Character arrays [dcl.init.string]
- Subscripting [expr.sub]
- Additive operators [expr.add]
- Array-to-pointer conversion [conv.array]
- Sizeof [expr.sizeof]
- Functions [dcl.fct]
- Lifetime [basic.life]
- N4950 — Working Draft, Standard for Programming Language C++