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 تلقائيًّا مع حساب موضع

المعاملات

val

المتغير أو القيمة المراد تنسيقها كسلسلة نصية. نوع البيانات المسموح بها هي: سلسلة نصية، ومحرف، وبايت، وعدد صحيح، وعدد صحيح عديم الإشارة، وعدد طويل عديم الإشارة، وعدد عشري، وعدد عشري مضاعف.

base

معامل اختياري يحدِّد أساس النظام العددي الذي ستُنسَّق فيه القيمة العددية.

decimalPlaces

يقيد عدد المنازل العشرية (الأرقام بعد الفاصلة) للعدد العشري أو العدد العشري المضاعف.

القيم المعادة

تعاد نسخة من الصنف String تحوي القيمة val.

أمثلة

جميع الأمثلة التالية هي أمثلة صحيحة لاستعمال الدالة String()‎:

String stringOne = "Hello String";                        // استعمال سلسلة نصية ثابتة
String stringOne =  String('a');                          // تحويل محرف ثابت إلى سلسلة نصية
String stringTwo =  String("This is a string");           // String تحويل سلسلة نصية ثابتة إلى كائن من النوع
String stringOne =  String(stringTwo + " with more");     // جمع سلسلتين نصيتين مع بعضهما بعضًا
String stringOne =  String(13);                           // استعمال عدد صحيح ثابت
String stringOne =  String(analogRead(0), DEC);           // استعمال عدد صحيح مع تحديد الأساس المستعمل
String stringOne =  String(45, HEX);                      // "استعمال عدد صحيح مع تحديد الأساس  إلى "ست عشري
String stringOne =  String(255, BIN);                     // "استعمال عدد صحيح مع تحديد الأساس إلى "ثنائي
String stringOne =  String(millis(), DEC);                // استعمال عدد طويل مع تحديد الأساس المستعمل
String stringOne =  String(5.698, 3);                     // استعمال عدد عشري مع تحديد عدد المنازل العشرية

مصادر

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