Arduino sprintf, e transformando um float em texto
Iniciante
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
sprintf(buffer, format, values...) writes formatted text into a char array: sprintf(buf, "%02d:%02d", 7, 5) makes "07:05". %d is a whole number, %s is text, %x is hex, and %02d pads to two digits with zeros. On an Uno there is one big catch: %f does not work, and a float prints as a question mark. Turn the float into text first with dtostrf() or String(value, 2).
The circuit above is a DHT11 on an Uno. Press Run and it prints "temperature 22 C, humidity 45 %" every two seconds, built from five Serial.print() calls. Below, the same kind of line comes from one snprintf, along with a clock with leading zeros, a float to two decimals, long numbers, hex, and the ways a format goes wrong, each run on an Uno with what it printed.
A clock with leading zeros
The format is text with gaps in it. Each % starts a gap and the values after the format fill them in order. %02d means a whole number, at least two characters wide, padded with zeros, so 7 hours and 5 minutes printed "07:05".
The buffer has to hold every character plus the zero byte that ends the text: "07:05" is five characters, so char buf[6]. sprintf has no idea how big your buffer is.
void setup() {
Serial.begin(9600);
char buf[6];
int hours = 7;
int minutes = 5;
sprintf(buf, "%02d:%02d", hours, minutes);
Serial.println(buf);
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Por que %f imprime um ponto de interrogação
O sprintf do Uno deixa os floats de fora para economizar flash, então %f e %.2f imprimem "?". A primeira linha abaixo imprimiu "t=?". Não é um bug no seu sketch, e a IDE do Arduino faz o mesmo num Uno, Nano ou Mega.
dtostrf(value, width, decimals, buffer) transforma um float em texto que %s aceita. Com width 1 fica tão curto quanto possível: a segunda linha imprimiu "t=23.46". Um width maior preenche à esquerda, então dtostrf(23.456, 6, 2, s) deu " 23.46". String(celsius, 2) faz o mesmo em uma etapa e imprimiu 23.46.
As placas ESP32 têm o sprintf completo: o mesmo %.2f imprimiu "t=23.46" em um ESP32-C3, e o Serial delas também tem printf(). O Serial do Uno na IDE do Arduino não tem printf(), então em uma compilação para o Uno monte o texto com sprintf e imprima com print.
void setup() {
Serial.begin(9600);
char buf[16];
float celsius = 23.456;
sprintf(buf, "t=%.2f", celsius);
Serial.println(buf);
char number[8];
dtostrf(celsius, 1, 2, number);
sprintf(buf, "t=%s", number);
Serial.println(buf);
String text = String(celsius, 2);
Serial.println(text);
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
A linha do sensor em uma chamada
Aqui estão as leituras do DHT11 em uma linha só. dtostrf dá à temperatura uma casa decimal, a umidade é convertida para int para %d, e %% imprime o sinal de porcentagem. Com 22.4 e 45 imprimiu "22.4 C, 45 %".
snprintf é um sprintf que recebe também o tamanho do buffer, então ele para antes do fim e nunca escreve além dele. Use-o sempre que o texto puder variar de tamanho.
void setup() {
Serial.begin(9600);
float celsius = 22.4;
float humidity = 45.0;
char temp[8];
dtostrf(celsius, 4, 1, temp);
char line[32];
snprintf(line, sizeof(line), "%s C, %d %%", temp, (int)humidity);
Serial.println(line);
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Números longos precisam de %ld
%d é um int, 16 bits no Uno. Dê a ele um long com 100000 e imprimiu -31072, os 16 bits de baixo lidos como um int. O Clang avisou format specifies type 'int' but the argument has type 'long'; o GCC diz format '%d' expects argument of type 'int', but argument 3 has type 'long int'. Use %ld para um long e %lu para um unsigned long como millis(); %lu imprimiu 4000000.
O mesmo vale para ints grandes: 40000 não cabe em um int, então é um long e também precisa de %ld. Por %d imprimiu -25536.
Hex, larguras e alinhamento
%x prints hex in small letters and %X in capitals, so 255 gave ff and FF. 0x%02X on the byte 0x0A printed "0x0A", the usual way to show an I2C address or a register. A width without a zero pads with spaces: %5d put 42 at the right of five characters and %-5d at the left, which lines columns up on the serial monitor.
Três jeitos de dar errado
Um buffer pequeno demais: o sketch abaixo escreve "Hello, world", treze bytes com o zero dele, em char small[6]. Nada avisou. Imprimiu "Hell", depois "He" e "Hel" repetidamente: os bytes extras tinham sobrescrito o lugar para onde setup() retorna, então o sketch recomeçava do início cada vez que setup() terminava, cortando a linha que ainda estava saindo. Onde um retorno destruído cai depende de onde tudo o mais está na memória, então o mesmo erro pode imprimir outra coisa em outro dia; é isso que o torna perigoso. snprintf com tamanho 8 cortou "abcdefghijk" para "abcdefg", sete letras e o byte zero, e retornou 11, o comprimento que ele queria, então dá para perceber que o texto foi cortado.
Uma String em %s: sprintf(buf, "%s", String("hi")) parou a compilação com cannot pass non-trivial object of type 'String' to variadic function, e o clang acrescentou did you mean to call the c_str() method? String("hi").c_str() imprimiu hi.
Um valor para cada espaço: sprintf lê um valor para cada %, em ordem, seja lá o que você passou. Um valor faltando ou de tipo errado imprime coisa sem sentido em vez de parar a compilação, então leia os avisos na aba de compilação.
void setup() {
Serial.begin(9600);
char small[6];
sprintf(small, "%s", "Hello, world");
Serial.println(small);
Serial.println("next line");
}
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 DHT11 imprimindo temperatura e umidade, ligado como o que roda no topo desta página. Mude um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
Por que o sprintf %f não funciona no Arduino?
No Uno, Nano e Mega, o sprintf é compilado sem suporte a float para economizar flash, então %f imprime um ponto de interrogação. Converta o float com dtostrf() ou String(value, 2) e imprima com %s. As placas ESP32 suportam %f.
How do I convert a float to a string with 2 decimals on Arduino?
String(value, 2) para uma String, ou dtostrf(value, 1, 2, buffer) para um vetor de char com espaço para os dígitos, o ponto e o byte zero.
Qual é a diferença entre sprintf e snprintf?
snprintf também recebe o tamanho do buffer e nunca escreve além dele, cortando o texto se precisar. sprintf escreve tanto quanto o formato mandar, mesmo além do fim do buffer.
How do I print a number with leading zeros on Arduino?
Formate com %02d para dois dígitos ou %04d para quatro, e então imprima o buffer. 7 com %02d vira 07.
Posso usar Serial.printf em um Arduino Uno?
Não na IDE do Arduino: o Serial das placas AVR não tem printf(). Monte a linha com snprintf e imprima com Serial.println(). As placas ESP32 e ESP8266 têm Serial.printf().
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.