Belajar

Arduino sprintf, dan mengubah float menjadi teks

Pemula

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: DHT11 mencetak suhu dan kelembapanlive0.000 s 0.00x
Klik untuk membukanya di editor
Setiap dua detik sketch mencetak satu baris hasil pengukuran ke Serial Monitor.

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.

Jam dan menit
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() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Kenapa %f mencetak tanda tanya

sprintf di Uno menghilangkan float untuk menghemat flash, jadi %f dan %.2f keduanya mencetak "?". Baris pertama di bawah mencetak "t=?". Itu bukan bug di sketch-mu, dan Arduino IDE juga melakukan hal yang sama di Uno, Nano, atau Mega.

dtostrf(value, width, decimals, buffer) mengubah float menjadi teks yang bisa diterima %s. Dengan width 1 hasilnya sesingkat mungkin: baris kedua mencetak "t=23.46". Width yang lebih lebar menambah spasi di kiri, jadi dtostrf(23.456, 6, 2, s) menghasilkan " 23.46". String(celsius, 2) melakukan hal yang sama dalam satu langkah dan mencetak 23.46.

Board ESP32 punya sprintf lengkap: %.2f yang sama mencetak "t=23.46" di ESP32-C3, dan Serial-nya juga punya printf(). Serial pada Uno di Arduino IDE tidak punya printf(), jadi di Uno buat teksnya dengan sprintf lalu print.

Float ke string di Uno
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() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Baris sensor dalam satu panggilan

Ini pembacaan DHT11 sebagai satu baris. dtostrf memberi suhu satu angka desimal, kelembapan di-cast ke int untuk %d, dan %% mencetak tanda persen. Dengan 22.4 dan 45 hasilnya "22.4 C, 45 %".

snprintf adalah sprintf dengan ukuran buffer yang ikut diberikan, jadi ia berhenti sebelum akhir dan tidak pernah menulis melewatinya. Gunakan ini setiap kali panjang teksnya bisa berubah-ubah.

snprintf dengan float di dalamnya
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() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Angka long butuh %ld

%d adalah int, 16 bit di Uno. Beri ia long berisi 100000 dan hasilnya -31072, 16 bit bawah dibaca sebagai int. Clang memperingatkan format specifies type 'int' but the argument has type 'long'; GCC menyebutnya format '%d' expects argument of type 'int', but argument 3 has type 'long int'. Gunakan %ld untuk long dan %lu untuk unsigned long seperti millis(); %lu mencetak 4000000.

Hal yang sama berlaku untuk int besar: 40000 tidak muat dalam int, jadi ini long dan juga butuh %ld. Lewat %d hasilnya -25536.

Heksadesimal, width, dan merapikan kolom

%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.

Tiga cara kesalahannya terjadi

Buffer terlalu kecil: sketch di bawah menulis "Hello, world", tiga belas byte termasuk nolnya, ke dalam char small[6]. Tidak ada peringatan. Ia mencetak "Hell", lalu "He" dan "Hel" berulang-ulang: byte tambahan menimpa alamat kembali setup(), jadi sketch mulai lagi dari awal setiap kali setup() selesai, memotong baris yang masih keluar. Ke mana alamat kembali yang rusak jatuh tergantung posisi lainnya di memori, jadi kesalahan yang sama bisa mencetak hal lain di lain hari; itulah yang membuatnya berbahaya. snprintf dengan ukuran 8 memotong "abcdefghijk" menjadi "abcdefg", tujuh huruf plus byte nol, dan mengembalikan 11, panjang yang ia inginkan, jadi kamu bisa tahu teksnya terpotong.

String pada %s: sprintf(buf, "%s", String("hi")) menghentikan build dengan cannot pass non-trivial object of type 'String' to variadic function, dan clang menambahkan did you mean to call the c_str() method? String("hi").c_str() mencetak hi.

Satu nilai untuk setiap celah: sprintf membaca satu nilai untuk setiap %, berurutan, apa pun yang kamu berikan. Nilai yang kurang atau salah jenis akan mencetak hasil yang tidak masuk akal alih-alih menghentikan build, jadi baca peringatan di tab build.

Terlalu kecil: tiga belas byte ke enam
void setup() {
  Serial.begin(9600);
  char small[6];
  sprintf(small, "%s", "Hello, world");
  Serial.println(small);
  Serial.println("next line");
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Buka rangkaian ini di editor. Arduino Uno: sebuah DHT11 mencetak suhu dan kelembapan, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya lalu jalankan lagi.

Buka rangkaian ini

Pertanyaan

Kenapa sprintf %f tidak berfungsi di Arduino?

Di Uno, Nano, dan Mega, sprintf dibangun tanpa dukungan float untuk menghemat flash, jadi %f mencetak tanda tanya. Ubah float-nya dengan dtostrf() atau String(value, 2) lalu cetak dengan %s. Board ESP32 mendukung %f.

How do I convert a float to a string with 2 decimals on Arduino?

String(value, 2) untuk String, atau dtostrf(value, 1, 2, buffer) untuk array char dengan ruang untuk angkanya, titiknya, dan byte nol.

Apa bedanya sprintf dan snprintf?

snprintf juga menerima ukuran buffer dan tidak pernah menulis melewatinya, memotong teks bila perlu. sprintf menulis sepanjang formatnya, bahkan melewati akhir buffer.

How do I print a number with leading zeros on Arduino?

Format dengan %02d untuk dua digit atau %04d untuk empat, lalu print buffer-nya. 7 dengan %02d menjadi 07.

Bisakah aku pakai Serial.printf di Arduino Uno?

Tidak di Arduino IDE: Serial pada board AVR tidak punya printf(). Bangun barisnya dengan snprintf lalu Serial.println(). Board ESP32 dan ESP8266 punya Serial.printf().

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.