Aprender

const e #define no Arduino: duas formas de dar nome a um número

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: um pino com nome, piscandoao vivo0.000 s 0.00x
Aperte Rodar, depois mude LAMP para 12
const int LAMP = 13; names the pin once. Change it to 12 and the yellow lamp blinks instead.

Ambos dão um nome a um número, então você pode escrever LAMP em vez de 13 e mudar em um só lugar. const int LAMP = 13; cria uma variável com um tipo que nunca pode mudar. #define LAMP 13 diz ao compilador para encontrar todo LAMP no sketch e colar 13 no lugar antes de compilar qualquer coisa. Para números de pinos e configurações, use const: a referência do Arduino recomenda, e isso evita todos os erros abaixo.

O circuito acima é a bancada de código, uma Uno com três lâmpadas. Aperte Rodar. A lâmpada vermelha no pino 13 pisca, e o monitor serial imprime "hello from the board", "setup() has run once" e depois "loop() pass 1", "loop() pass 2" e assim por diante. O pino recebe nome uma única vez, no topo, como const int LAMP = 13;. Mude o 13 para 12, aperte Rodar, e o pino 12, a lâmpada amarela, pisca em vez da vermelha.

Abaixo está o que o #define faz, por que LED_BUILTIN é um deles, e os cinco jeitos de um #define dar errado onde um const não daria, cada um montado no Mokxi com o que imprimiu ou o erro que deu.

Quer a versão passo a passo? A aula "A program is a list" percorre isso com checkpoints.

Abrir a aula

Um nome para um pino

Aqui está o sketch inteiro rodando acima. LAMP é usado três vezes e definido uma única vez. Sem o nome, mudar o pino significaria achar todo 13 no sketch e torcer para nenhum deles querer dizer outra coisa.

const means the value is fixed. Try to change it, LAMP = 12; inside setup(), and the build stops: clang says cannot assign to variable 'LAMP' with const-qualified type 'const int', and the Arduino IDE’s GCC says assignment of read-only variable 'LAMP'. That is the point: a pin number that changes while the sketch runs is a bug.

firmware/uno/examples/cpphello (o sketch rodando acima)
const int LAMP = 13;

int passes = 0;

void setup() {
  pinMode(LAMP, OUTPUT);
  Serial.begin(115200);
  Serial.println("hello from the board");
  Serial.println("setup() has run once");
}

void loop() {
  passes = passes + 1;
  Serial.print("loop() pass ");
  Serial.println(passes);

  digitalWrite(LAMP, HIGH);
  delay(200);
  digitalWrite(LAMP, LOW);
  delay(800);
}

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

O que o #define realmente faz

Um #define não é uma variável. É um localizar e substituir, feito no texto do sketch antes de o compilador lê-lo. #define LAMP 13 não tem tipo e não ocupa memória; todo LAMP depois dele simplesmente vira 13.

Você já usa eles. LED_BUILTIN é #define LED_BUILTIN 13 no core da Uno, e imprimi-lo imprimiu 13. HIGH é um #define para 1 e imprimiu 1. Eles são escritos em maiúsculas por costume, então um nome em maiúsculas avisa o leitor de que pode ser um #define, e um const também costuma ser escrito em maiúsculas, porque faz o mesmo papel.

O ponto e vírgula e o sinal de igual

Uma linha de #define não é um comando, então não leva ponto e vírgula nem sinal de igual. Com #define LED 13;, o ponto e vírgula é colado junto com o 13, então pinMode(LED, OUTPUT); vira pinMode(13;, OUTPUT);. O clang diz expected ')', com uma nota apontando de volta ao #define, expanded from macro 'LED'; o GCC diz expected ')' before ';' token. O erro aparece na linha que usa o nome, não na linha errada, e é por isso que demora tanto para achar.

#define LED = 13 falha do mesmo jeito, como pinMode(= 13, OUTPUT), e o clang diz expected expression. Um const não permite nenhum dos dois erros: const int LED = 13; é um comando comum, com o sinal de igual e o ponto e vírgula nos seus devidos lugares.

Um ponto e vírgula colado
#define LED 13;

void setup() {
  pinMode(LED, OUTPUT);
}

void loop() {
}

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

Parênteses faltando

Como um #define cola texto, a soma que ele cola se mistura com o que está ao redor. Com #define WIDTH 10 + 5, WIDTH * 2 vira 10 + 5 * 2 e imprimiu 20, enquanto const int WIDTH_C = 10 + 5; dobrado imprimiu 30. Um #define que recebe um valor é pior: #define SQUARE(x) x * x transformou SQUARE(1 + 2) em 1 + 2 * 1 + 2 e imprimiu 5. Com parênteses em cada uso e no conjunto todo, ((x) * (x)), imprimiu 9.

Um #define também não tem tipo, então sua soma é feita em int. #define SECONDS 60 * 60 * 24 imprimiu 20864 para um dia, com um aviso de overflow, enquanto const long SECONDS_C = 60L * 60 * 24; imprimiu 86400. A página de tipos de dados explica o porquê.

Somas coladas
#define WIDTH 10 + 5
#define SQUARE(x) x * x
#define SQUARE_OK(x) ((x) * (x))
const int WIDTH_C = 10 + 5;

void setup() {
  Serial.begin(9600);
  Serial.println(WIDTH * 2);
  Serial.println(WIDTH_C * 2);
  Serial.println(SQUARE(1 + 2));
  Serial.println(SQUARE_OK(1 + 2));
  Serial.println(LED_BUILTIN);
  Serial.println(HIGH);
}

void loop() {
}

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

Nomes que colidem

Um #define substitui seu nome em todo lugar depois dele, em cada função, sem exceções. Depois de #define LED 13, uma linha dentro de setup() dizendo int LED = 5; vira int 13 = 5;, e o clang diz expected unqualified-id. A mesma coisa acontece com nomes que o core do Arduino já definiu. const float PI = 3.14; parece inofensivo e parou a compilação com o mesmo erro, porque PI já é um #define no core e a linha virou const float 3.14159... = 3.14;.

Defina o mesmo nome duas vezes e o segundo ganha, com apenas um aviso. #define LED 13 seguido de #define LED 12 imprimiu 12, e a aba de compilação disse 'LED' macro redefined. Dois const com o mesmo nome no mesmo lugar param a compilação, que é a resposta mais segura.

Para que o #define ainda serve

Use const para números, pinos e configurações, e constexpr para um valor calculado a partir de outros, como em constexpr int LIMIT = COUNT * 2;, que imprimiu 6. Um const int também pode definir o tamanho de um vetor: int pins[COUNT] com COUNT em 3 mediu 6 bytes, três ints de 2 bytes.

Um #define é a ferramenta certa para ligar e desligar partes do código antes da compilação. Com #define DEBUG no topo, as linhas entre #ifdef DEBUG e #endif entram na compilação, e nosso sketch imprimiu "start" e "debug: setup done". Apague o #define e o mesmo sketch imprimiu só "start", e as linhas de debug nunca foram compiladas.

Linhas de debug que vão e voltam
#define DEBUG

void setup() {
  Serial.begin(9600);
  Serial.println("start");
#ifdef DEBUG
  Serial.println("debug: setup done");
#endif
}

void loop() {
}

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

Abra este circuito no editor. Arduino Uno: um pino com nome, piscando, ligado como roda no topo desta página. Mude um componente ou um valor e rode de novo.

Perguntas

Devo usar const ou #define no Arduino?

Use const para números de pino e configurações. Ele tem um tipo, segue as regras normais para nomes e não cola por acidente um ponto e vírgula ou uma soma soltos. Deixe o #define para ligar e desligar partes do código com #ifdef.

Um #define usa memória em um Arduino?

Não. Ele é substituído antes da compilação, então só o número fica no código.

Por que um #define com ponto e vírgula dá erro?

Porque o ponto e vírgula é colado junto com o valor. #define LED 13; transforma pinMode(LED, OUTPUT) em pinMode(13;, OUTPUT), e o erro aparece nessa linha, não no #define.

O que significa "expected unqualified-id" com um #define?

Um nome que você usou já é um #define, então foi substituído por um número onde o compilador esperava um nome. O Arduino define PI, HIGH, LOW, INPUT e outros; escolha um nome diferente.

Qual é a diferença entre const e constexpr?

Os dois criam um valor que não pode mudar. constexpr também promete ao compilador que ele consegue calcular o valor durante a compilação, então pode ser usado em qualquer lugar onde um número fixo é necessário, como o tamanho de um array.

Qual é a diferença entre const int e int?

Um int pode mudar enquanto o sketch roda e um const int não. Escreva `LAMP = 12;` depois de `const int LAMP = 13;` e a compilação para com cannot assign to variable 'LAMP' with const-qualified type 'const int'; o GCC da IDE do Arduino diz assignment of read-only variable 'LAMP'. Esse erro é o objetivo: um número de pino não pode ser alterado por acidente.

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.