Arduino/stringobject

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

انظر أيضًا

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

مصادر

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