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

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