Arduino/string

يمكن تمثيل السلاسل النصية بطريقين. فإمَّا أن تُستخدَم السلاسل النصية كأحد أنواع البيانات في أردوينو والذي أصبح جزءًا من النواة بدءًا من الإصدار 0019، أو يمكن إنشاء سلسلة نصية من مصفوفة من المحارف مع وجود المحرف null في نهايتها؛ ستُشرَح الطريقة الثانية في هذه الصفحة. لمزيد من التفاصيل حول الكائن String الذي يوفر الكثير من الوظائف على حساب الذاكرة، اطلع على صفحة توثيقه.

البنية العامة

جميع الأمثلة التالية هي تصريحات صالحة للسلاسل النصية:

char Str1[15];
char Str2[8] = {'a', 'r', 'd', 'u', 'i', 'n', 'o'};
char Str3[8] = {'a', 'r', 'd', 'u', 'i', 'n', 'o', '\0'};
char Str4[ ] = "arduino";
char Str5[8] = "arduino";
char Str6[15] = "arduino";

يوجد عدَّة احتمالات متاحة للتصريح عن السلاسل النصية هي:

• التصريح عن مصفوفة من المحارف دون تهيئتها كما في المصفوفة Str1.
• التصريح عن مصفوفة من المحارف (مع زيادة الحجم لمحرف إضافي)، وسيضيف المصرَّف المحرف null المطلوب تلقائيًّا مثل المصفوفة Str2.
• هذه الحالة تشبه الحالة السابقة تمامًا باستثناء إضافة المحرف null بشكل صريح إلى المصفوفة مثل المصفوفة Str3.
• تهيئة المصفوفة بسلسلة نصية ثابتة تعطى ضمن علامتي اقتباس؛ سيختار المصرِّف عند تصريفه للشيفرة حجمًا ملائمًا للمصفوفة يسع السلسلة النصية الثابتة مع محرف الإنهاء null. انظر إلى المصفوفة Str4 التي تشرح هذه الحالة.
• تهيئة المصفوفة مع تحديد حجمها بصريح العبارة مثل المصفوفة Str5.
• تهيئة المصفوفة مع اختيار حجم زائد لتوفير إمكانية لسلسلة نصية أكبر مستقبلًا. انظر مثلًا إلى المصفوفة Str6 التي تمثِّل هذه الحالة.

محرف الإنهاء null

عمومًا، تُنهَى السلاسل النصية بالمحرف null (المحرف ASCII 0). هذا يسمح للدوال (مثل الدالة Serial.print()‎) بأن تعرف نهاية السلسلة النصية في الذاكرة. إن لم يكن محرف الإنهاء موجودًا، فستكمل الدالة قراءة البايتات المتلاحقة الموجودة في الذاكرة التي قد لا تكون جزءًا من السلسلة النصية نفسها.

هذا يعني أنَّ أي سلسلة نصية يجب أن تملك مساحة إضافية لمحرف زائد إضافةً إلى المحتوى الذي تريد تخزينه في السلسلة. هذا هو السبب الذي يفسِّر حاجة المصفوفة Str2 والمصفوفة Str5 إلى حجم بمقدار 8 رغم أنَّ حجم العبارة "arduino" هو 7 فقط، إذ سيُضاف في الموضع الأخير المتاح المحرف null تلقائيًّا. بالنسبة للمصفوفة Str4، سيحدَّد حجمها إلى 8 محارف تلقائيًّا مع أخذ محرف الإنهاء بالحسبان. في المصفوفة Str3، أضفنا المحرف null بصريح العبارة (يُكتَب '0\') يدويًّا.

انتبه إلى أنَّه من المحتمل وجود سلسلة نصية لا تملك محرف إنهاءٍ (مثل تحديد حجم المصفوفة Str2 إلى 7 بدلًا من 8). سيؤدي هذا إلى حدوث خلل في أغلب الدوال التي تتعامل مع السلاسل النصية، لذا يجب عليك تجنب فعل ذلك من غير قصد. إن لاحظت أنَّ سلوك البرنامج أصبح غريبًا بعض الشيء (خصوصًا عند التعامل مع المحارف وليس مع السلاسل النصية)، فيُحتمَل غالبًا أن يكون محرف الإنهاء هو مسبب المشكلة.

علامتي الإقتباس المفردة والمزدوجة

تعرَّف السلاسل النصية دومًا داخل علامتي اقتباس مزدوجة مثل "ABC"، وتعرَّف المحارف دومًا داخل علامتي اقتباس مفردة مثل 'A'.

التفاف السلاسل النصية الطويل

يمكن للسلاسل النصية الطويل الالتفاف والانتقال إلى السطر التالي بالشكل:

char myString[] = "هذا هو السطر الأول"
" وهذا السطر الثاني"
" وهلم جرًّا";

مصفوفات من سلاسل نصية

إنَّه من المناسب في كثير من الأحيان عند التعامل مع قدرٍ كبيرٍ من النصوص، مثل العمل على مشروع يحوي شاشة LCD، إنشاء مصفوفة من سلاسل نصية. لمَّا كانت السلاسل النصية هي مصفوفات بحد ذاتها، فسنلجأ في هذه الحالة إلى استعمال مصفوفة ثنائية الأبعاد.

في المثال الآتي، وجود المعامل * بعد تعريف نوع البيانات الذي هو char بالشكل "*char" يشير إلى أنَّ المصفوفة المراد التصريح عنها هي مصفوفة من المؤشِّرات (pointers). حقيقيةً، جميع المصفوفات هي مؤشِّرات، لذا استعمال المعامل * بهذا الشكل مهم لإنشاء مصفوفةٍ من مصفوفات. المؤشرات في لغة C معقدةٌ بعض الشيء ولا يفهمها الكثير من المبرمجين المبتدئين، ولكن يكفي فهم المؤشرات بشكل سطحي فقط للتعامل معها في حالتنا هذه.

أمثلة

مثالٌ على تعرف مصفوفة من مصفوفات باستعمال المعامل * وطباعة محتوي هذه المصفوفة على الواجهة التسلسلية:

char* myStrings[]={"This is string 1", "This is string 2", "This is string 3",
"This is string 4", "This is string 5","This is string 6"};

void setup(){
Serial.begin(9600);
}

void loop(){
for (int i = 0; i < 6; i++){
   Serial.println(myStrings[i]);
   delay(500);
   }
}

مصادر

• صفحة النوع String في توثيق أردوينو الرسمي.