التابع String.toCharArray()‎ في أردوينو

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

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

string.toCharArray(buf, len)

تمثِّل string السلسلة النصية التي يراد نسخها إلى الذاكرة buf ذات الحجم len التي تمثِّل مصفوفةً من المحارف.

المعاملات

buf

الذاكرة المراد نسخ محارف السلسلة النصية المعطاة إليها. تمثِّل هذه الذاكرة مصفوفة من المحارف.

len

عددٌ صحيحٌ يحدِّد طول الجزء المراد نسخه وتحويله.

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

لا يعاد أي شيء.

أمثلة

مثال على استعمال التابع toCharArray()‎:

String stringValue = "wiki Hsoub";
char buf[] = "";

void setup() {
   Serial.begin(9600);
}

void loop() {
  stringValue.toCharArray(buf, 8);
  Serial.println(buf); // wiki Hs
}

انظر أيضًا

• التابع c_str()‎: يحوِّل محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف null).
• التابع toInt()‎: يحول السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ.
• التابع toFloat()‎: يحوِّل السلسلة النصية التي استدعيت معه إلى عددٍ عشري. 
• التابع toLowerCase()‎: يحوِّل جميع حروف السلسلة النصية التي استدعيت معه إلى حروف صغيرة (lower-case).
• التابع toUpperCase()‎: يحوِّل جميع حروف السلسلة النصية التي استدعيت معه إلى حروف كبيرة (upper-case).

مصادر

• صفحة التابع toCharArray()‎ في توثيق أردوينو الرسمي.