Arduino sprintf, và cách biến float thành văn bản
Cơ bản
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
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() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Vì sao %f in ra dấu hỏi
sprintf trên Uno bỏ qua float để tiết kiệm flash, nên %f và %.2f đều in ra "?". Dòng đầu tiên bên dưới in ra "t=?". Đây không phải lỗi trong sketch của bạn, và Arduino IDE cũng làm vậy trên Uno, Nano hay Mega.
dtostrf(value, width, decimals, buffer) biến một số float thành văn bản mà %s nhận được. Với width bằng 1 thì ngắn nhất có thể: dòng thứ hai in ra "t=23.46". Width lớn hơn sẽ đệm thêm bên trái, nên dtostrf(23.456, 6, 2, s) cho ra " 23.46". String(celsius, 2) làm điều tương tự trong một bước và in ra 23.46.
Các bo mạch ESP32 có đầy đủ sprintf: cùng một %.2f đã in "t=23.46" trên ESP32-C3, và Serial của chúng cũng có printf(). Serial của Uno trong Arduino IDE không có printf(), nên với Uno hãy dựng văn bản bằng sprintf rồi in ra.
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() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Dòng cảm biến trong một lần gọi
Đây là số đọc của DHT11 gộp trên một dòng. dtostrf đưa nhiệt độ về một chữ số thập phân, độ ẩm được ép kiểu sang int cho %d, và %% in dấu phần trăm. Với 22.4 và 45 nó in ra "22.4 C, 45 %".
snprintf là sprintf nhưng có thêm kích thước bộ đệm, nên nó dừng trước khi hết chỗ và không bao giờ ghi tràn. Hãy dùng nó mỗi khi văn bản có thể dài ngắn khác nhau.
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() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Số kiểu long cần %ld
%d là int, 16 bit trên Uno. Đưa vào một long chứa 100000 thì nó in ra -31072, là 16 bit thấp được đọc như một int. Clang cảnh báo format specifies type 'int' but the argument has type 'long'; GCC diễn đạt là format '%d' expects argument of type 'int', but argument 3 has type 'long int'. Dùng %ld cho long và %lu cho unsigned long như millis(); %lu đã in ra 4000000.
Tương tự với số int lớn: 40000 không vừa một int nên nó là long và cũng cần %ld. Qua %d nó in ra -25536.
Hex, độ rộng và thẳng cột
%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.
Ba cách nó hỏng
Bộ đệm quá nhỏ: sketch bên dưới ghi "Hello, world", mười ba byte tính cả ký tự kết thúc, vào char small[6]. Không có cảnh báo nào. Nó in "Hell", rồi "He" và "Hel" lặp đi lặp lại: các byte dư đã ghi đè lên chỗ setup() quay về, nên mỗi lần setup() kết thúc sketch lại chạy từ đầu, cắt cụt dòng đang gửi. Nơi trả về bị hỏng rơi vào đâu còn tùy mọi thứ khác nằm ở đâu trong bộ nhớ, nên cùng lỗi đó hôm khác có thể in ra thứ khác; đó là điều khiến nó nguy hiểm. snprintf với kích thước 8 đã cắt "abcdefghijk" còn "abcdefg", bảy chữ cái và byte kết thúc, và trả về 11, là độ dài nó muốn ghi, nên bạn có thể biết văn bản đã bị cắt.
Một String trong %s: sprintf(buf, "%s", String("hi")) làm bản dựng dừng với cannot pass non-trivial object of type 'String' to variadic function, và clang thêm did you mean to call the c_str() method? String("hi").c_str() đã in ra hi.
Mỗi chỗ trống một giá trị: sprintf đọc một giá trị cho mỗi dấu %, theo thứ tự, bất kể bạn truyền gì. Thiếu giá trị hay sai kiểu sẽ in ra vô nghĩa chứ không làm bản dựng dừng, nên hãy đọc cảnh báo trong bảng biên dịch.
void setup() {
Serial.begin(9600);
char small[6];
sprintf(small, "%s", "Hello, world");
Serial.println(small);
Serial.println("next line");
}
void loop() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Mở mạch này trong trình soạn thảo. Arduino Uno: một DHT11 in nhiệt độ và độ ẩm, được nối như mô phỏng chạy ở đầu trang này. Thử đổi một linh kiện hoặc một giá trị rồi chạy lại.
Mở mạchCâu hỏi
Tại sao sprintf %f không hoạt động trên Arduino?
Trên Uno, Nano và Mega, sprintf được dựng không hỗ trợ float để tiết kiệm flash, nên %f in ra dấu chấm hỏi. Hãy chuyển float bằng dtostrf() hoặc String(value, 2) rồi in với %s. Các bo mạch ESP32 hỗ trợ %f.
How do I convert a float to a string with 2 decimals on Arduino?
String(value, 2) nếu muốn một String, hoặc dtostrf(value, 1, 2, buffer) cho một mảng char đủ chỗ cho các chữ số, dấu chấm và byte kết thúc.
Sự khác nhau giữa sprintf và snprintf là gì?
snprintf nhận thêm kích thước bộ đệm và không bao giờ ghi tràn, thay vào đó cắt bớt văn bản. sprintf ghi hết mọi thứ định dạng tạo ra, kể cả vượt quá hết bộ đệm.
How do I print a number with leading zeros on Arduino?
Định dạng bằng %02d cho hai chữ số hoặc %04d cho bốn, rồi in bộ đệm. Số 7 với %02d thành 07.
Có dùng được Serial.printf trên Arduino Uno không?
Không trong Arduino IDE: Serial của các bo mạch AVR không có printf(). Hãy dựng dòng văn bản bằng snprintf rồi Serial.println() nó. Các bo mạch ESP32 và ESP8266 có Serial.printf().
Tiếp tục nào
Thông tin trên trang này lấy từ đâu
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.