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: تنشئ نسخةً من الصنف String الذي يوفِّر الكثير من الأدوات للتعامل مع السلاسل النصية وإجراء عمليات عليها.

• النوع array: يمثِّل مصفوفة من المتغيرات الموضوعة في وعاء واحد والتي يمكن الوصول إليها والتعامل معها عبر رقم فهرس كلٍّ منها.
• النوع bool: يخزِّن المتغير الذي يصرَّح عنه بأنَّه من النوع bool إحدى القيمتين المنطقيَّتين التاليتين: true، أو false عبر حجز بايتٍ واحدٍ من الذاكرة فقط.
• النوع byte: يُخزِّن عددًا عديم الإشارة بحجم 8 بت؛ أي من القيمة 0 إلى القيمة 255.
• النوع char: يحجز بايتًا واحدًا من الذاكرة ويخزِّن فيه قيمة محرف.
• النوع double: يحجز أربعة بايتات (32 بت) من الذاكرة فقط في لوحات أردوينو Uno (والتي تعتمد على متحكمات ATMega) أو ثمانية بايتات (64 بت) في اللوحات Due لتخزين عدد عشري فيها.
• النوع float: يحجز أربعة بايتات (32 بت) من الذاكرة لتخزين عدد عشري فيها.
• النوع int: يحجز حجمًا مقداره 16 بت (2 بايت) من الذاكرة في لوحات أردوينو Uno (والتي تعتمد على متحكمات ATMega) أو 32 بت (4 بايت) في لوحات أردوينو Due (والتي تعتمد على متحكمات SAMD) لتخزين عدد صحيح فيه.
• النوع long: يحجز حجمًا كبيرًا من الذاكرة مقداره 4 بايت يستعمل لتخزين الأعداد الصحيحة التي تتسم بأنَّها طويلة.
• النوع short: يحجز في جميع لوحات أردوينو (التي تعتمد على المتحكمات ATMega و ARM) حجمًا من الذاكرة مقداره 16 بت (2 بايت) لتخزين عدد قصير فيه.
• النوع unsigned char: يحجز حجمًا من الذاكرة مقداره 1 بايت فقط.
• النوع unsigned int: يحجز حجمًا من الذاكرة مقداره 2 بايت في لوحات أردونيو Uno واللوحات التي تعتمد على متحكمات ATMega أو 4 بايت في لوحات أردوينو Due لتخزين عدد صحيح عديم الإشارة فيها.
• النوع unsigned long: يحجز حجمًا كبيرًا من الذاكرة مقداره 4 بايت يُستعمَل لتخزين الأعداد الصحيحة عديمة الإشارة التي تتسم بأنَّها طويلة.
• النوع word: يُخزِّن أعدادًا عديم الإشارة بحجم 2 بايت.

مصادر

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