Aprender

Arrays no Arduino: uma lista de coisas com um nome só

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: oito padrões num array, em oito lâmpadasao vivo0.000 s 0.00x
Clique para abrir no editor
Um laço for percorre um array de oito bytes e mostra cada um nas lâmpadas.

Um array é uma lista de valores do mesmo tipo com um nome só. int pins[] = {13, 12, 11}; cria uma lista de três números, pins[0] é o primeiro, e um laço for pode percorrer a lista inteira. Arrays são como um sketch guarda uma fileira de pinos de LED, uma melodia, um conjunto de padrões de luz ou as últimas dez leituras de um sensor.

O circuito acima guarda oito padrões de luz num array e os mostra em oito lâmpadas por um registrador de deslocamento. Aperte Rodar. O monitor serial imprime "patterns in the list: 8", depois "step 0 = 1", "step 1 = 11" e segue até "step 7 = 11111111" enquanto a barra acende uma lâmpada por vez. Cada passo é uma entrada da lista.

Abaixo está como criar um array e contá-lo, por que a primeira entrada é o número 0, e os dois erros que custam mais tempo: ler ou escrever depois do fim, e perguntar a uma função qual é o tamanho de um array.

Quer a versão passo a passo? A aula "Um loop sobre uma lista" percorre isso com checkpoints.

Abrir a aula

Crie um, e conte a partir do zero

Escreva o tipo, o nome, colchetes e os valores entre chaves. Deixe os colchetes vazios e o compilador conta os valores para você. As entradas são numeradas a partir de 0, então um array de oito tem PATTERNS[0] a PATTERNS[7], e não existe PATTERNS[8].

You can also give the size and fill it in later: int readings[10]; makes ten ints. A global array like that starts as all zeros. One made inside a function starts with whatever was in memory, so fill it before you read it.

firmware/uno/examples/cpparray (a lista e o laço rodando acima)
const byte PATTERNS[] = {
  0b00000001,
  0b00000011,
  0b00000111,
  0b00001111,
  0b00011111,
  0b00111111,
  0b01111111,
  0b11111111,
};

const int COUNT = (int)(sizeof(PATTERNS) / sizeof(PATTERNS[0]));

Quantos: sizeof

sizeof dá o tamanho de algo em bytes, não o número de entradas. Então a contagem é o tamanho do array inteiro dividido pelo tamanho de uma entrada. Para cinco ints num Uno, sizeof(scores) imprimiu 10, porque um int lá tem 2 bytes. O mesmo sketch num ESP32-C3 imprimiu 20, porque um int lá tem 4. Dividido pelo tamanho de uma entrada, ambos disseram 5.

Calcule a contagem assim em vez de digitar 8 à mão. Adicione um nono padrão à lista acima e aperte Rodar: a primeira linha vira "patterns in the list: 9", o laço roda nove passos, e você não mexeu em nada além da lista.

O tamanho em bytes, e a contagem
int scores[5] = {10, 20, 30, 40, 50};

void setup() {
  Serial.begin(9600);
  Serial.println(sizeof(scores));
  Serial.println(sizeof(scores) / sizeof(scores[0]));
}

void loop() {
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Um array de pinos

O array mais útil num Arduino é uma lista de pinos. Coloque os números dos pinos num array e um laço configura todos, e outro acende um por um. O sketch abaixo roda nas três lâmpadas da bancada de código (pinos 13, 12 e 11) e imprimiu "pin 13 on", "pin 12 on" e "pin 11 on" nessa ordem. Adicione um pino à lista, ligue mais um LED, e ele entra na dança.

Arrays of text work the same way. const char *names[] = {"red", "yellow", "green"}; is a list of three words, and names[1] is "yellow". The random numbers page uses one to make a magic eight ball.

Um array também pode guardar linhas. const byte GRID[2][3] = {{1, 2, 3}, {4, 5, 6}}; são duas linhas de três, GRID[1][0] imprimiu 4, e sizeof(GRID) imprimiu 6, duas linhas de três bytes. Dois laços for, um dentro do outro, percorrem todas as entradas, que é como um sketch guarda os pontos de uma matriz de LEDs ou as teclas de um teclado.

Uma lista de pinos
const int LAMPS[] = {13, 12, 11};
const int COUNT = sizeof(LAMPS) / sizeof(LAMPS[0]);

void setup() {
  Serial.begin(9600);
  for (int i = 0; i < COUNT; i++) {
    pinMode(LAMPS[i], OUTPUT);
  }
}

void loop() {
  for (int i = 0; i < COUNT; i++) {
    digitalWrite(LAMPS[i], HIGH);
    Serial.print("pin ");
    Serial.print(LAMPS[i]);
    Serial.println(" on");
    delay(300);
    digitalWrite(LAMPS[i], LOW);
  }
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Depois do fim: sem erro, respostas erradas

Nothing checks an index while the sketch runs. Ask for entry 5 of a five-entry array and the board does not stop or complain; it reads whatever two bytes come next in memory. Our a[5] printed 280, a number that was never in the list. The build tab did warn about that one, because the 5 was written right there in the code: array index 5 is past the end of the array (that has type 'int[5]').

Escrever depois do fim é pior, e geralmente não dá aviso nenhum, porque o índice é um contador de loop. Preenchemos um array de cinco posições com um loop que dizia i <= 5, e uma variável chamada other, declarada na linha seguinte, mudou de 99 para 0. Nada foi impresso e nada travou. Um sketch que faz isso dá erro em outro lugar totalmente diferente, e é por isso que o bug é tão difícil de encontrar. Use < com a contagem, sempre.

Uma posição depois do fim
int a[5] = {10, 20, 30, 40, 50};
int other = 99;

void setup() {
  Serial.begin(9600);
  for (int i = 0; i <= 5; i++) a[i] = 0;
  Serial.println(other);
}

void loop() {
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Passar um array para uma função

Um array entregue a uma função chega como o endereço da sua primeira posição, não como uma cópia da lista. Isso tem dois efeitos. A função pode alterar o array de quem chamou, o que muitas vezes é o que você quer. E dentro da função, sizeof não sabe mais o tamanho dele: o mesmo scores que media 10 bytes em setup() media 2 dentro de uma função, o tamanho de um endereço num Uno. A aba de compilação avisou: sizeof on array function parameter will return size of 'int *' instead of 'int[]'.

Então passe a contagem junto com o array, como average(scores, 5), ou calcule com sizeof onde o array foi criado e passe esse valor. Toda biblioteca do Arduino que recebe um buffer faz assim.

Abra este circuito no editor. Arduino Uno: oito padrões num array, em oito lâmpadas, ligados como aparece no topo desta página. Mude um componente ou um valor e rode de novo.

Perguntas

Arrays no Arduino começam em 0 ou 1?

Em 0. A primeira posição de um array é name[0] e a última de um array de oito é name[7]. Um loop sobre ele é for (int i = 0; i < 8; i++).

Como descubro o tamanho de um array no Arduino?

Divida o tamanho dele em bytes pelo tamanho de uma posição: sizeof(list) / sizeof(list[0]). Isso só funciona onde o array foi declarado; dentro de uma função que recebeu o array, sizeof devolve o tamanho de um endereço.

Posso mudar o tamanho de um array?

Não. O tamanho dele é fixado quando o sketch é compilado. Faça ele do tamanho que você vai precisar e guarde uma contagem separada de quantas posições estão em uso.

O que acontece se eu passar do fim de um array?

Nada impede. Ler depois do fim devolve o que estiver logo em seguida na memória, e escrever depois do fim altera outra variável. No nosso teste, escrever uma posição a mais mudou uma variável vizinha de 99 para 0, sem erro nenhum.

Um array pode guardar texto?

Yes. const char *names[] = {"red", "yellow", "green"}; is an array of three strings, and names[0] is "red". A single piece of text is itself an array of char, ending in a zero byte.

Fontes

De onde vêm as informações desta página

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.