Arduino sprintf, y convertir un float en texto
Principiante
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las 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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Por qué %f imprime un signo de interrogación
El sprintf del Uno deja fuera los floats para ahorrar flash, así que %f y %.2f imprimen "?". La primera línea de abajo imprimió "t=?". No es un error de tu sketch, y el Arduino IDE hace lo mismo en un Uno, Nano o Mega.
dtostrf(value, width, decimals, buffer) convierte un float en texto que %s puede tomar. Con un width de 1 queda tan corto como se puede: la segunda línea imprimió "t=23.46". Un width más ancho rellena a la izquierda, así que dtostrf(23.456, 6, 2, s) dio " 23.46". String(celsius, 2) hace lo mismo en un solo paso e imprimió 23.46.
Las placas ESP32 tienen el sprintf completo: el mismo %.2f imprimió "t=23.46" en un ESP32-C3, y su Serial también tiene printf(). El Serial del Uno en el Arduino IDE no tiene printf(), así que en una compilación para el Uno arma el texto con sprintf y 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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
La línea del sensor en una sola llamada
Aquí están las lecturas del DHT11 en una sola línea. dtostrf le da a la temperatura un decimal, la humedad se convierte a int para %d, y %% imprime un signo de porcentaje. Con 22.4 y 45 imprimió "22.4 C, 45 %".
snprintf es sprintf con el tamaño del buffer pasado como argumento, así que se detiene antes del final y nunca escribe más allá. Úsalo siempre que el texto pueda variar en longitud.
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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Los números long necesitan %ld
%d es un int, de 16 bits en un Uno. Dale un long con 100000 e imprimió -31072, los 16 bits de abajo leídos como int. Clang advirtió format specifies type 'int' but the argument has type 'long'; GCC lo expresa como format '%d' expects argument of type 'int', but argument 3 has type 'long int'. Usa %ld para un long y %lu para un unsigned long como millis(); %lu imprimió 4000000.
Lo mismo pasa con ints grandes: 40000 no cabe en un int, así que es un long y también necesita %ld. Con %d imprimió -25536.
Hex, anchos y alinear columnas
%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.
Tres formas en que sale mal
Un buffer demasiado pequeño: el sketch de abajo escribe "Hello, world", trece bytes con su cero, en char small[6]. Nada lo advirtió. Imprimió "Hell", luego "He" y "Hel" una y otra vez: los bytes extra habían sobrescrito el lugar al que regresa setup(), así que el sketch volvía a empezar desde arriba cada vez que setup() terminaba, cortando la línea que aún salía. Dónde aterriza un retorno arruinado depende de dónde quede todo lo demás en memoria, así que el mismo error puede imprimir otra cosa otro día; eso es lo que lo hace peligroso. snprintf con un tamaño de 8 cortó "abcdefghijk" a "abcdefg", siete letras y el byte cero, y devolvió 11, la longitud que quería, así que puedes notar que el texto fue cortado.
Un String en %s: sprintf(buf, "%s", String("hi")) detuvo la compilación con cannot pass non-trivial object of type 'String' to variadic function, y clang agregó did you mean to call the c_str() method? String("hi").c_str() imprimió hi.
Un valor para cada hueco: sprintf lee un valor por cada %, en orden, sin importar lo que pasaste. Un valor faltante o de tipo equivocado imprime cosas sin sentido en lugar de detener la compilación, así que lee las advertencias en la pestaña de compilación.
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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Abre este circuito en el editor. Arduino Uno: un DHT11 que imprime temperatura y humedad, cableado como se ejecuta en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿Por qué sprintf %f no funciona en Arduino?
En el Uno, el Nano y el Mega, sprintf se compila sin soporte de float para ahorrar flash, así que %f imprime un signo de interrogación. Convierte el float con dtostrf() o String(value, 2) e imprímelo con %s. Las placas ESP32 sí soportan %f.
How do I convert a float to a string with 2 decimals on Arduino?
String(value, 2) para un String, o dtostrf(value, 1, 2, buffer) para un arreglo char con espacio para los dígitos, el punto y el byte cero.
¿Cuál es la diferencia entre sprintf y snprintf?
snprintf también recibe el tamaño del buffer y nunca escribe más allá, cortando el texto si hace falta. sprintf escribe todo lo que el formato genere, incluso pasado el final del buffer.
How do I print a number with leading zeros on Arduino?
Formátalo con %02d para dos dígitos o %04d para cuatro, y luego imprime el buffer. 7 con %02d queda como 07.
¿Puedo usar Serial.printf en un Arduino Uno?
No en el Arduino IDE: el Serial de las placas AVR no tiene printf(). Arma la línea con snprintf y Serial.println(). Las placas ESP32 y ESP8266 sí tienen Serial.printf().
Sigue así
De dónde vienen los datos de esta página
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.