الكائن String في أردوينو

تنشئ الدالة String()‎ نسخةً من الصنف String. هنالك طرائق متعدِّدة لإنشاء سلاسل نصية من أنواع مختلفة من البيانات وهي استدعاء الدالة String()‎ مع:

• سلسلة نصية ثابتة من المحارف ضمن علامتي اقتباس مزدوجتين (أي مصفوفة من المحارف)، أو
• محرف ثابت وحيد ضمن علامتي اقتباس مفردتين، أو
• نسخة أخرى من الكائن String، أو
• عدد صحيح ثابت أو عدد طويل ثابت، أو
• عدد صحيح ثابت أو عدد طويل ثابت باستعمال أساس محدَّد، أو
• عدد صحيح أو عدد طويل متغير، أو
• عدد صحيح أو عدد طويل متغير باستعمال أساس محدَّد، أو
• عدد عشري أو عدد عشري مضاعف باستعمال منازل عشرية محدَّدة.

إن استدعيت الدالة String()‎ مع عدد، فستُنشِئ سلسلةً نصيةً تحوي تمثيلًا لأرقام ذلك العدد عبر محارف ASCII. الأساس الافتراضي المستعمل في هذه الحالة هو 10. سيعطي المثال التالي:

String thisString = String(13);

السلسلة النصية "13". يمكن استعمال أساس مختلف مثل:

String thisString = String(13, HEX);

الذي سيعطي السلسلة النصية "D" وهي التمثيل الست عشري للقيمة 13 العشرية. إن كنت تفضل النظام الثنائي، فجرب هذا المثال:

String thisString = String(13, BIN);

الذي سيعطي السلسلة النصية "1101" وهي التمثيل الثنائي للقيمة 13 العشرية.

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

String(val)
String(val, base)
String(val, decimalPlaces)

المعاملات

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);                     // استعمال عدد عشري مع تحديد عدد المنازل العشرية

التوابع

charAt()‎

يجلب التابع charAt()‎ محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معه.

compareTo()‎

يوازن التابع compareTo()‎ بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين.

concat()‎

يضيف التابع concat()‎ المعامل المُمرَّر إليه إلى السلسلة النصية التي استدعيت معه.

c_str()‎

تحوِّل الدالة c_str()‎ محتوى السلسلة النصية التي استدعيت معها إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف null).

endsWith()‎

يتحقَّق التابع endsWith()‎ إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه.

equals()‎

يتحقَّق التابع equals()‎ إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.

equalsIgnoreCase()‎

يتحقَّق التابع equalsIgnoreCase()‎ إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه مع عدم أخذ حالة الأحرف بالحسبان.

getBytes()‎

يجلب التابع getBytes()‎ عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعها في مخزَّن معيَّن.

indexOf()‎

يعيد التابع indexOf()‎ فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.

lastIndexOf()‎

يعيد التابع lastIndexOf()‎ فهرس آخر ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.

length()‎

يعيد التابع length()‎ عدد محارف السلسلة النصية التي استدعيت معه.

remove()‎

يحذف التابع remove()‎ عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها.

replace()‎

يبدِّل التابع replace()‎ محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.

reserve()‎

يحجز التابع reserve()‎ جزءًا من الذاكرة ويخصِّصه للتلاعب بالسلسلة النصية التي استدعيت معه وتعديلها.

setCharAt()‎

يعيِّن التابع setCharAt()‎ قيمة محرفٍ متوضِّع في السلسلة النصية التي استدعيت معه إلى المحرفالمُمرَّر إليه.

startsWith()‎

يتحقَّق التابع startsWith()‎ إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.

substring()‎

يجلب التابع substring()‎ جزءًا محدَّدًا من السلسلة النصية التي استدعيت معه.

toCharArray()‎

يحول التابع toCharArray()‎ كامل السلسلة النصية التي استدعيت معه أو جزءًا منها إلى سلسلة نصية مكوَّنة من مصفوفة من المحارف.

toInt()‎

يحول التابع toInt()‎ السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ.

toFloat()‎

يحوِّل التابع toFloat()‎ السلسلة النصية التي استدعيت معه إلى عددٍ عشري.

toLowerCase()‎

يحوِّل التابع toLowerCase()‎ جميع حروف السلسلة النصية التي استدعيت معها إلى حروف صغيرة (lower-case).

toUpperCase()‎

يحوِّل التابع toUpperCase()‎ جميع حروف السلسلة النصية التي استدعيت معه إلى حروف كبيرة (upper-case).

trim()‎

يزيل التابع trim()‎ جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.

انظر أيضًا

• النوع array: يمثِّل مصفوفة من المتغيرات الموضوعة في وعاء واحد والتي يمكن الوصول إليها والتعامل معها عبر رقم فهرس كلٍّ منها.
• النوع string: يمثِّل سلسلةً نصيةً مؤلفةً من عدة محارف مرتبطة مع بعضها بعضًا. تُستعمَل مصفوفة من المحارف لتخزين هذا النوع من البيانات واستدعائها والتعامل معها لاحقًا.

مصادر

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