Arrays no Arduino: uma lista de coisas com um nome só
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
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 aulaCrie 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.
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.
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.
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.
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.
Continuar
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.