عرض مصدر Arduino/stringobject/tochararray

<noinclude>{{DISPLAYTITLE:التابع <code>String.toCharArray()‎</code> في أردوينو}}</noinclude>
يحول التابع <code>toCharArray()‎</code> كامل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه أو جزءًا منها إلى [[Arduino/string|سلسلة نصية]] مكوَّنة من مصفوفة من المحارف.
==البنية العامة==
<syntaxhighlight lang="arduino">
string.toCharArray(buf, len)

</syntaxhighlight>تمثِّل <code>string</code> [[Arduino/stringobject|السلسلة النصية]] التي يراد نسخها إلى الذاكرة <code>buf</code> ذات الحجم <code>len</code> التي تمثِّل [[Arduino/string|مصفوفةً من المحارف]].
==المعاملات==
===<code>buf</code>===
الذاكرة المراد نسخ محارف [[Arduino/stringobject|السلسلة النصية]] المعطاة إليها. تمثِّل هذه الذاكرة [[Arduino/string|مصفوفة من المحارف]].
===<code>len</code>===
عددٌ صحيحٌ يحدِّد طول الجزء المراد نسخه وتحويله.
==القيم المعادة==
لا يعاد أي شيء.
==أمثلة==
مثال على استعمال التابع <code>toCharArray()‎</code>:<syntaxhighlight lang="arduino">
String stringValue = "wiki Hsoub";
char buf[] = "";

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

void loop() {
  stringValue.toCharArray(buf, 8);
  Serial.println(buf); // wiki Hs
}
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Arduino/stringobject/c str|c_str()‎]]</code>: يحوِّل محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف <code>null</code>).
*التابع <code>[[Arduino/stringobject/toint|toInt()‎]]</code>: يحول [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/int|عددٍ صحيحٍ]].
*التابع <code>[[Arduino/stringobject/tofloat|toFloat()‎]]</code>: يحوِّل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/float|عددٍ عشري]]. 
*التابع <code>[[Arduino/stringobject/tolowercase|toLowerCase()‎]]</code>: يحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى حروف صغيرة (lower-case).
*التابع <code>[[Arduino/stringobject/touppercase|toUpperCase()‎]]</code>: يحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى حروف كبيرة (upper-case).
==مصادر==
*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/tochararray/ صفحة التابع toCharArray()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino String]]