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

مصادر

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