Ponteiros no Arduino, em duas lâmpadas e uma função que divide um delay pela metade
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
A pointer is a variable that holds the address of another variable. &speed is the address of speed, int *p = &speed; keeps that address in p, and *p goes to the address, so *p = 50; changes speed. On an Uno an address is 2 bytes. Pointers are how a function changes the caller’s variable, and how an array reaches a function at all.
O circuito acima é duas lâmpadas em uma Uno cujo tempo de piscar é alterado por um ponteiro. Aperte Rodar. O monitor serial imprime "onMs before = 400" e "onMs after = 200", porque halve(&onMs) entregou à função o endereço de onMs e ela dividiu o que estava lá pela metade. Depois vêm "sizeof(int*) = 2", "sum of rates = 1500" e duas taxas lidas por um ponteiro, 100 e 400.
Abaixo estão & e *, ponteiros versus referências, arrays como ponteiros, percorrer uma string, ponteiros de função e os erros, cada um rodado em uma Uno com o que imprimiu.
Quer a versão passo a passo? A aula "Onde uma coisa mora" percorre isso com checkpoints.
Abrir a aulaOs dois símbolos
Em uma declaração, * significa "ponteiro para": int *value é um ponteiro para um int. Em todo outro lugar, *value significa "o int naquele endereço", e &onMs significa "o endereço de onMs". Aqui está a função do sketch acima. Ela nunca vê onMs em si, só onde ele mora, e *value = *value / 2; lê o que está lá e escreve metade de volta.
Sem o ponteiro, uma função recebe uma cópia do número e a variável de quem chamou fica como estava. Esse é todo o motivo para entregar um endereço.
static void halve(int *value) {
*value = *value / 2;
}Uma função que altera duas variáveis
Trocar dois números é o teste clássico. swap(&x, &y) abaixo imprimiu "8 3", então as duas variáveis de quem chamou mudaram. Uma referência em C++ faz o mesmo trabalho com menos pontuação: int &a na lista de parâmetros, e nenhum & ou * em outro lugar. swapRef(x, y) trocou de volta e imprimiu "3 8".
As bibliotecas do Arduino usam os dois. Uma referência não pode ser vazia nem ser movida para apontar para outro lugar; um ponteiro pode ser nullptr, o que uma função pode testar, e pode percorrer um array.
void swap(int *a, int *b) {
int keep = *a;
*a = *b;
*b = keep;
}
void swapRef(int &a, int &b) {
int keep = a;
a = b;
b = keep;
}
void setup() {
Serial.begin(9600);
int x = 3, y = 8;
swap(&x, &y);
Serial.print(x);
Serial.print(" ");
Serial.println(y);
swapRef(x, y);
Serial.print(x);
Serial.print(" ");
Serial.println(y);
}
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 chega como um ponteiro
An array handed to a function is handed over as a pointer to its first element. So in the sketch below, sizeof(rates) printed 8, four ints of 2 bytes, but the same sizeof inside show() printed 2: the size of a pointer. Clang warned: sizeof on array function parameter will return size of 'int *' instead of 'int[]'. That is why a function that takes an array also takes its length, as sumOf(rates, RATE_COUNT) does above.
Indexes and pointers are two spellings of one thing. With int *p = rates;, both *(p + 3) and p[3] printed 800. p++ moves the pointer on by one int, 2 bytes, so *p then printed 200.
int rates[] = {100, 200, 400, 800};
void show(int list[]) {
Serial.println(sizeof(list));
}
void setup() {
Serial.begin(9600);
Serial.println(sizeof(rates));
show(rates);
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Percorrer uma string, e uma lista de funções
A string in quotes is a row of characters with a zero byte at the end, and const char *message = "Mokxi"; points at its first letter. A loop that moves the pointer until it reaches the zero printed "M o k x i". That is how strlen() and Serial.print() find the end of your text.
Um ponteiro também pode guardar o endereço de uma função. O sketch abaixo guarda três funções em um array e chama cada uma em sequência; imprimiu "slow", "fast" e "off". Um menu ou um conjunto de padrões de luz escolhidos por um botão é o uso comum: o botão muda um número, e modes[number]() roda aquele modo.
void slow() {
Serial.println("slow");
}
void fast() {
Serial.println("fast");
}
void off() {
Serial.println("off");
}
void (*modes[])() = {slow, fast, off};
void setup() {
Serial.begin(9600);
for (int i = 0; i < 3; i++) {
modes[i]();
}
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Erros, feitos de propósito
Um número onde vai um endereço: int *p = x; parou a compilação com cannot initialize a variable of type 'int *' with an lvalue of type 'int'. O GCC diz invalid conversion from 'int' to 'int*'. Escreva &x.
Um endereço que já não existe: uma função que retorna um ponteiro para seu próprio array local entrega memória que é reutilizada assim que ela retorna. O Clang avisou address of stack memory associated with local variable 'text' returned, e o sketch imprimiu uma linha vazia em vez de "ready". O GCC diz address of local variable 'text' returned. Torne o array static, ou faça quem chamou passar um buffer para preencher.
O endereço de nada: um ponteiro definido como nullptr não aponta para nada. Teste if (p == nullptr) antes de usar um que talvez não tenha sido definido; aquele sketch imprimiu "points at nothing".
Abra este circuito no editor. Arduino Uno: duas lâmpadas e um delay dividido pela metade por um ponteiro, ligados como rodam no topo desta página. Troque um componente ou um valor e rode de novo.
Perguntas
O que é um ponteiro no Arduino?
Uma variável que guarda o endereço de memória de outra variável em vez de um valor. Em um Uno ela tem 2 bytes. *p lê ou escreve o que estiver naquele endereço.
Qual é a diferença entre * e & em código Arduino?
& antes de uma variável dá o endereço dela. * em uma declaração cria um ponteiro, e * antes de um ponteiro em qualquer outro lugar vai até o valor para o qual ele aponta. Em uma lista de parâmetros, & depois de um tipo cria uma referência.
Devo usar um ponteiro ou uma referência?
Use uma referência quando uma função precisa alterar uma variável que o chamador sempre tem. Use um ponteiro quando pode não haver nada para apontar, ou para percorrer um array.
Por que o sizeof dá errado dentro da minha função?
O array chegou como um ponteiro, então o sizeof dá o tamanho do ponteiro, 2 bytes em um Uno. Passe o comprimento como um segundo parâmetro, calculado com sizeof onde o array é declarado.
Preciso de ponteiros para programar um Arduino?
Não para começar. Você os usa sem perceber sempre que passa um array ou uma string para uma função, e precisa deles para escrever uma função que altera as variáveis do chamador ou para manter uma lista de funções.
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.