Arduino sprintf، وتحويل float إلى نص
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
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() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
لماذا يطبع %f علامة استفهام
تترك sprintf في Uno الأعداد العشرية float خارجًا توفيرًا للفلاش، لذا %f و%.2f كلاهما يطبع "؟". السطر الأول أدناه طبع "t=?". هذا ليس خطأ في كودك، وArduino IDE يفعل الشيء نفسه على Uno أو Nano أو Mega.
dtostrf(value, width, decimals, buffer) يحوّل قيمة float إلى نص يمكن أن يأخذه %s. مع عرض قدره 1 يكون النص بأقصر صورة ممكنة: السطر الثاني طبع "t=23.46". العرض الأكبر يضيف فراغات على اليسار، لذا dtostrf(23.456, 6, 2, s) أعطى " 23.46". أما String(celsius, 2) فيفعل الشيء نفسه في خطوة واحدة وقد طبع 23.46.
تملك لوحات ESP32 نسخة sprintf الكاملة: نفس %.2f طبع "t=23.46" على لوحة ESP32-C3، كما أن الشاشة التسلسلية فيها تدعم printf() أيضًا. الشاشة التسلسلية للوحة Uno في Arduino IDE لا تملك printf()، لذا اكتب النص بـ sprintf على 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() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
سطر الحساس في استدعاء واحد
هذه قراءات DHT11 في سطر واحد. يعطي dtostrf الحرارة خانة عشرية واحدة، وتُحوَّل الرطوبة إلى int من أجل %d، و%% يطبع علامة النسبة المئوية. مع 22.4 و45 طُبع "22.4 C, 45 %".
الدالة snprintf هي sprintf مع تمرير حجم المخزن المؤقت، فتتوقف قبل النهاية ولا تكتب بعده أبدًا. استخدمها كلما أمكن أن يختلف طول النص.
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() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
الأرقام الطويلة تحتاج %ld
%d مخصص لـ int وهو 16 بت على Uno. مرّر له قيمة long تحمل 100000 فطُبع -31072، وهي آخر 16 بت مقروءة كـ int. حذّر Clang بصيغة format specifies type 'int' but the argument has type 'long'؛ أما GCC فيقولها بصيغة format '%d' expects argument of type 'int', but argument 3 has type 'long int'. استخدم %ld لقيمة long و%lu لقيمة unsigned long مثل millis()؛ وقد طبع %lu القيمة 4000000.
الأمر نفسه ينطبق على الأعداد الصحيحة الكبيرة: الرقم 40000 لا يتسع في int، فهو long ويحتاج %ld كذلك. عبر %d طُبع -25536.
النظام السداسي العشري، العروض، والمحاذاة
%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.
ثلاث طرق يخطئ بها الأمر
مخزن مؤقت أصغر من اللازم: الكود أدناه يكتب "Hello, world"، ثلاثة عشر بايت مع صفرها، في char small[6]. لم يظهر أي تحذير. طبع "Hell"، ثم "He" ثم "Hel" مرارًا: البايتات الزائدة كانت قد كتبت فوق المكان الذي تعود إليه setup()، فبدأ الكود من جديد كل مرة تنتهي فيها setup()، مقطعًا السطر الذي ما يزال يخرج. أين تقع النهاية المدمّرة يعتمد على أين يجلس كل شيء آخر في الذاكرة، لذا قد يطبع نفس الخطأ شيئًا مختلفًا في يوم آخر؛ وهذا ما يجعله خطيرًا. أما snprintf بحجم 8 فقد قصّ "abcdefghijk" إلى "abcdefg"، سبعة أحرف مع بايت الصفر، وأعاد 11، الطول الذي أراده، فيمكنك أن تعرف أن النص قُصّ.
قيمة String داخل %s: sprintf(buf, "%s", String("hi")) أوقف البناء برسالة cannot pass non-trivial object of type 'String' to variadic function، وأضاف clang عبارة did you mean to call the c_str() method? أما String("hi").c_str() فقد طبع hi.
قيمة لكل فراغ: يقرأ sprintf قيمة واحدة لكل %، بالترتيب، أيًّا كان ما مرّرته. قيمة ناقصة أو من نوع خاطئ تطبع كلامًا بلا معنى بدلًا من إيقاف البناء، لذا اقرأ التحذيرات في تبويب البناء.
void setup() {
Serial.begin(9600);
char small[6];
sprintf(small, "%s", "Hello, world");
Serial.println(small);
Serial.println("next line");
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
افتح هذه الدائرة في المحرر. Arduino Uno: حساس DHT11 يطبع الحرارة والرطوبة، موصّلًا كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّله من جديد.
افتح الدائرةالأسئلة
لماذا لا يعمل sprintf %f على Arduino؟
على Uno وNano وMega تُبنى sprintf بدون دعم الأعداد العشرية توفيرًا لذاكرة flash، فيطبع %f علامة استفهام. حوّل قيمة float بـ dtostrf() أو String(value, 2) واطبعها بـ %s. لوحات ESP32 تدعم %f.
How do I convert a float to a string with 2 decimals on Arduino?
String(value, 2) لقيمة String، أو dtostrf(value, 1, 2, buffer) لمصفوفة char فيها متسع للأرقام والنقطة وبايت الصفر.
ما الفرق بين sprintf و snprintf؟
تأخذ snprintf أيضًا حجم المخزن المؤقت ولا تكتب بعده أبدًا، بل تقصّ النص بدلًا من ذلك. أما sprintf فتكتب كل ما يولّده التنسيق، حتى بعد نهاية المخزن المؤقت.
How do I print a number with leading zeros on Arduino?
نسّقه بـ %02d لخانتين أو %04d لأربع خانات، ثم اطبع المخزن المؤقت. الرقم 7 مع %02d يصبح 07.
هل يمكنني استخدام Serial.printf على Arduino Uno؟
ليس في Arduino IDE: كائن Serial على لوحات AVR لا يملك printf(). ابنِ السطر بـ snprintf ثم اطبعه بـ Serial.println(). لوحات ESP32 وESP8266 تملك Serial.printf().
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.