تعلّم

سلاسل Arduino: نص يمكنك وصله ومقارنته وتفكيكه

مبتدئ

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: رسالة تمر على شاشة LCD مقاس 16x2مباشر0.000 s 0.00x
اضغط لفتحه في المحرر
السطر السفلي يطبع مصفوفة char من نقطة بداية متحركة، فينزلق النص عبر الشاشة.

في Arduino نوعان من النصوص. String بحرف S كبير هي كائن يكبر حسب حاجتك: اربط اثنتين بعلامة +، وقارنهما بـ ==، وحوّل "42" إلى العدد 42 بواسطة toInt(). أما مصفوفة الأحرف مثل char name[] = "Mokxi"; فهي النوع القديم من لغة C: صف من الأحرف ينتهي ببايت صفر. معظم المبتدئين يحتاجون String، ومعظم المكتبات تعطيك مصفوفات أحرف.

الدائرة أعلاه هي شاشة LCD من مقاس 16 في 2 على لوحة Uno. اضغط «تشغيل». السطر الأول يعرض "Mokxi LCD1602" والسطر الثاني يمرّر "Hello from the Uno!" عبر الشاشة حرفًا واحدًا في كل مرة. الرسالة هي مصفوفة أحرف، والكود يطبعها بدءًا من حرف مختلف كل 300 ms.

فيما يلي كيفية إنشاء Strings وربطها وتحويلها ومقارنتها وتقسيمها، والأخطاء الأربعة التي تطبع الشيء الخطأ أو توقف البناء، وكيف تُرتَّب مصفوفة الأحرف، وكل ذلك مشغَّل على لوحة Uno مع ما طبعته.

الرسالة المتحركة هي مصفوفة من الحروف

هذا هو الكود الذي يعمل أعلاه. MESSAGE تحمل 22 حرفًا ومسافات، ويضيف المترجم بايت صفر في النهاية، لذا فإن sizeof(MESSAGE) - 1 هو عدد الحروف. في كل دورة، تطبع الحلقة 16 منها بدءًا من start، و% length يعيد العدّ إلى البداية، فتلتقي نهاية الرسالة ببدايتها.

غيّر النص بين علامتي الاقتباس واضغط «تشغيل»، فتعرض شاشة LCD كلماتك بدلًا منها. اترك المسافات الثلاث في النهاية؛ فهي الفراغ قبل أن تعود الرسالة من جديد.

firmware/uno/examples/sflcd (الكود الذي يعمل أعلاه)
const char MESSAGE[] = "Hello from the Uno!   ";
int start = 0;

void setup() {
  lcd.begin(16, 2);
  lcd.print("Mokxi LCD1602");
  Serial.begin(9600);
  Serial.println("Mokxi Uno: LCD1602 on pins 4, 6 and 10 to 13");
}

void loop() {
  int length = sizeof(MESSAGE) - 1;
  lcd.setCursor(0, 1);
  for (int i = 0; i < 16; i++) lcd.print(MESSAGE[(start + i) % length]);
  start = (start + 1) % length;
  delay(300);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

أنشئ String واربطها

تُنشأ String من نص بين علامتي اقتباس مزدوجتين، و+ يربطها بمزيد من النص أو String أخرى أو عدد داخل String(). الكود أدناه طبع "Hello, Mokxi!" وlength() وهي 13. += يضيف إلى نهاية String لديك بالفعل: "Count: 5" أصبحت "Count: 5 lamps".

String() تكتب الأعداد أيضًا بالطريقة التي تطلبها. String(3.14159, 3) طبعت 3.142 بثلاثة منازل. String(255, HEX) طبعت ff وString(5, BIN) طبعت 101، وهذا مفيد لعرض مسجّل حساس أو بتات بايت.

اربط نصًا وأعدادًا
void setup() {
  Serial.begin(9600);
  String name = "Mokxi";
  String greeting = "Hello, " + name + "!";
  Serial.println(greeting);
  Serial.println(greeting.length());
  int count = 5;
  String line = "Count: " + String(count);
  Serial.println(line);
  line += " lamps";
  Serial.println(line);
  Serial.println(String(3.14159, 3));
  Serial.println(String(255, HEX));
  Serial.println(String(5, BIN));
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

علامة + التي لا تربط

+ لا يربط إلا إذا كان أحد الطرفين String. النص بين علامتي الاقتباس وحده هو مصفوفة أحرف، وإضافة عدد إليها تحرّك الموضع داخلها بدلًا من ذلك. String line = "Count: " + count; مع قيمة count تساوي 5 تخطّت أول خمسة أحرف وطبعت ": ". وقد حذّر Clang: adding 'int' to a string does not append to the string. والحل هو الطريقة أعلاه: "Count: " + String(count).

لا يمكن جمع نصين بين علامتي اقتباس أصلًا. String both = "Hello" + "World"; أوقف البناء: يقول clang ‏invalid operands to binary expression ('const char[6]' and 'const char[6]')، ويقول GCC الخاص بـ Arduino IDE ‏invalid operands of types 'const char [6]' and 'const char [6]' to binary 'operator+'. اجعل الأول String: String("Hello") + "World"، ويسير الباقي بعدها.

علامات الاقتباس مهمة أيضًا. الاقتباس المفرد لحرف واحد، 'A'. String s = 'hi'; أوقف البناء بسبب no viable conversion from 'int' to 'String'، بعد تحذير عن multi-character character constant. النص دائمًا بين علامتي اقتباس مزدوجتين.

من String إلى عدد والعكس

toInt() يقرأ العدد في بداية String. String a = "42"; ثم a.toInt() + 1 طبع 43. يتوقف عند أول حرف ليس جزءًا من عدد، لذا "12abc" أعطت 12، ويتخطى المسافات في البداية، لذا " 7" أعطت 7، ويعطي 0 حين لا يوجد عدد إطلاقًا: "abc" أعطت 0. toFloat() يفعل الشيء نفسه مع الأعداد العشرية، و"3.75" مضاعفة طبع 7.50.

toInt() يعيد قيمة long، فيستطيع قراءة الأعداد الكبيرة، لكن المتغير الذي تحفظه فيه يجب أن يكون كبيرًا بما يكفي أيضًا. "99999" طبع 99999 مباشرة من toInt()، و-31073 بعد تخزينها في int، الذي يتوقف على Uno عند 32767. احفظها في long. وفي الاتجاه الآخر، يصبح العدد String بواسطة String(42).

من نص إلى أعداد
void setup() {
  Serial.begin(9600);
  String a = "42";
  Serial.println(a.toInt() + 1);
  Serial.println(String("12abc").toInt());
  Serial.println(String("abc").toInt());
  Serial.println(String(" 7").toInt());
  String t = "3.75";
  float f = t.toFloat();
  Serial.println(f * 2);
  Serial.println(String("99999").toInt());
  int n = String("99999").toInt();
  Serial.println(n);
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

قارن Strings ومصفوفات الأحرف

== يقارن بين String حرفًا بحرف، والأحرف الكبيرة تُحتسب: "ON" == "on" طبعت 0، أي خطأ. equalsIgnoreCase() طبعت 1، أو نادِ toLowerCase() على الـ String أولًا ثم قارن. compareTo() يرتّب الكلمات أبجديًا: مقارنة "apple" بـ "banana" تعطي أقل من صفر.

مع مصفوفات الأحرف، == لا يقارن الحروف إطلاقًا؛ بل يسأل هل هي مخزّنة في المكان نفسه. char word[] = "on"; ثم if (word == "on") طبعت "different". وقد حذّر Clang: result of comparison against a string literal is unspecified (use an explicit string comparison function instead). تلك الدالة هي strcmp()، وتعيد 0 عندما تتطابق القيمتان: strcmp(word, "on") == 0 طبعت "strcmp: same".

المقارنة
void setup() {
  Serial.begin(9600);
  String cmd = "ON";
  Serial.println(cmd == "on");
  Serial.println(cmd.equalsIgnoreCase("on"));
  cmd.toLowerCase();
  Serial.println(cmd == "on");
  char word[] = "on";
  if (word == "on") Serial.println("same");
  else Serial.println("different");
  if (strcmp(word, "on") == 0) Serial.println("strcmp: same");
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

قسّم سطرًا: indexOf() وsubstring()

كثيرًا ما يرسل حساس أو لوحة أخرى عدة قيم في سطر واحد بينها فواصل، مثل "21.5,48,1013". indexOf(',') يجد موضع أول فاصلة، وهو 4 هنا، وindexOf(',', first + 1) يجد الفاصلة التالية بعدها. substring(from, to) تقتطع الجزء الواقع بينهما، من from حتى ما قبل to، وtoFloat() أو toInt() يحوّل كل جزء إلى عدد. الكود أدناه طبع 21.50 و48 و1013.

indexOf() يعيد -1 حين لا يجد شيئًا، فتحقّق من ذلك قبل الاقتطاع. وهناك أخرى تظهر كثيرًا: charAt(0) أو data[0] يعطي حرفًا واحدًا، وreplace("l", "L") حوّلت "Hello" إلى "HeLLo"، وtoUpperCase() جعلتها "HELLO"، وtrim() يزيل المسافات ونهايات الأسطر من الطرفين، وهو كما تعرض صفحة القراءة التسلسلية غالبًا ما تحتاجه المقارنة.

ثلاث قيم من سطر واحد
void setup() {
  Serial.begin(9600);
  String data = "21.5,48,1013";
  int first = data.indexOf(',');
  int second = data.indexOf(',', first + 1);
  float temp = data.substring(0, first).toFloat();
  int humidity = data.substring(first + 1, second).toInt();
  long pressure = data.substring(second + 1).toInt();
  Serial.println(temp);
  Serial.println(humidity);
  Serial.println(pressure);
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

مصفوفات الأحرف والصفر في النهاية

char name[] = "Mokxi"; تحمل خمسة أحرف وبايتًا إضافيًا، وهو صفر، يعلّم النهاية. sizeof(name) طبع 6 وstrlen(name)، التي تعدّ حتى الصفر، طبع 5. كل حرف هو عنصر مثل أي مصفوفة: name[0] طبع M، وبعد name[0] = 'm'; طبع الاسم "mokxi".

يتحوّل بين String ومصفوفة الأحرف في الاتجاهين. String s = name; ينشئ String من المصفوفة، وs.c_str() يسلّم String إلى دالة تريد مصفوفة أحرف، كما تفعل كثير من دوال المكتبات.

تحتفظ String بحروفها في ذاكرة تطلبها أثناء عمل الكود وتعيدها عند الانتهاء. على لوحة Uno، ذات 2048 بايت من الذاكرة لكل شيء، قد ينفد الكود الذي يبني Strings طويلة مرارًا في loop() من الذاكرة بعد ساعات من العمل. للرسائل القصيرة لا داعي للقلق. أما لكود يعمل أيامًا، فاحفظ النصوص في مصفوفات أحرف أو نادِ reserve() مرة واحدة في setup()؛ وصفحة الذاكرة المنخفضة فيها الباقي.

افتح هذه الدائرة في المحرر. ‏Arduino Uno: رسالة تتحرك على شاشة LCD مقاس 16x2، موصَّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

افتح الدائرة

الأسئلة

ما الفرق بين String وstring في Arduino؟

String بحرف S كبير هي الكائن الخاص بـ Arduino يمكنك دمجه مع +، ومقارنته بـ ==، وتحويله بـ toInt()‎. أما string بحرف صغير فتعني عادةً مصفوفة أحرف (char array)، مثل char name[] = "Mokxi";، أي سلسلة من الأحرف تنتهي ببايت صفري.

كيف أحوّل String إلى int في Arduino؟

استدعِ عليها toInt()‎: فالدالة String("42").toInt()‎ تعطي 42. وهي تعيد قيمة long وتعطي 0 عندما لا يبدأ النص برقم. استخدم toFloat()‎ للأعداد العشرية.

كيف أدمج String مع رقم؟

ضع الرقم داخل String()‎: "Count: " + String(count). بدون ذلك، فإن "Count: " + count تنقل المؤشر في النص بعدد الأحرف count بدلًا من الدمج، وتطبع جزءًا منه.

كيف أقارن بين نصين في Arduino؟

تتم مقارنة نصين String بـ ==، وتُحتسب الأحرف الكبيرة؛ واستخدم equalsIgnoreCase()‎ لتجاهلها. أما مصفوفات الأحرف فاستخدم معها strcmp(a, b) == 0، لأن == على مصفوفات الأحرف تقارن مكان تخزينها لا ما تقوله.

كيف أقسّم String على الفواصل؟

ابحث عن كل فاصلة بـ indexOf(',')‎، واقتطع الأجزاء بـ substring()‎، ثم حوّلها بـ toInt()‎ أو toFloat()‎. المثال في هذه الصفحة يقرأ ثلاث قيم من "21.5,48,1013".

كيف أحصل على طول String في Arduino؟

`s.length()‎` تعدّ الأحرف: "Hello" بعد إضافة " world" إليها طُبع 11. وللمصفوفة الأحرف، تعطي `strlen(c)` القيمة 11 أيضًا، بينما تعطي `sizeof(c)` القيمة 12، لأنها تحسب أيضًا البايت الصفري الذي يُنهي النص.

المصادر

من أين جاءت الحقائق في هذه الصفحة

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.