الفرق بين المراجعتين لصفحة: «Arduino/stringobject/tochararray»

المراجعة الحالية بتاريخ 06:23، 7 نوفمبر 2018

يحول التابع 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()‎ في توثيق أردوينو الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:التابع <code>String.toCharArray()‎</code> في أردوينو}}</noinclude>
 يحول التابع <code>toCharArray()‎</code> كامل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه أو جزءًا منها إلى [[Arduino/string|سلسلة نصية]] مكوَّنة من مصفوفة من المحارف.
 ==البنية العامة==
 <syntaxhighlight lang="arduino">
@@ سطر 7: / سطر 6: @@
 </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>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/c str|c_str()‎]]</code>: يحوِّل محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف <code>null</code>).
-* التابع <code>[[Arduino/stringobject/toint|toInt()‎]]</code>: يحول [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/int|عددٍ صحيحٍ]].
+*التابع <code>[[Arduino/stringobject/toint|toInt()‎]]</code>: يحول [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/int|عددٍ صحيحٍ]].
-* التابع <code>[[Arduino/stringobject/tofloat|toFloat()‎]]</code>: يحوِّل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/float|عددٍ عشري]].
+*التابع <code>[[Arduino/stringobject/tofloat|toFloat()‎]]</code>: يحوِّل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/float|عددٍ عشري]].
-* التابع <code>[[Arduino/stringobject/tolowercase|toLowerCase()‎]]</code>: يحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى حروف صغيرة (lower-case).
+*التابع <code>[[Arduino/stringobject/tolowercase|toLowerCase()‎]]</code>: يحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى حروف صغيرة (lower-case).
-* التابع <code>[[Arduino/stringobject/touppercase|toUpperCase()‎]]</code>: يحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى حروف كبيرة (upper-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()‎ في توثيق أردوينو الرسمي.]