الفرق بين المراجعتين لصفحة: «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|سلسلة نصية]] مكوَّنة من مصفوفة من المحارف.
+يحول التابع <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/string/toint|toInt()‎]]</code>: تحول [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى [[Arduino/int|عددٍ صحيحٍ]].
+*التابع <code>[[Arduino/stringobject/c str|c_str()‎]]</code>: يحوِّل محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف <code>null</code>).
-* الدالة <code>[[Arduino/string/tofloat|toFloat()‎]]</code>: تحوِّل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى [[Arduino/float|عددٍ عشري]].
+*التابع <code>[[Arduino/stringobject/toint|toInt()‎]]</code>: يحول [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/int|عددٍ صحيحٍ]].
-* الدالة <code>[[Arduino/string/tolowercase|toLowerCase()‎]]</code>: تحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى حروف صغيرة (lower-case).
+*التابع <code>[[Arduino/stringobject/tofloat|toFloat()‎]]</code>: يحوِّل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/float|عددٍ عشري]].
-* الدالة <code>[[Arduino/string/touppercase|toUpperCase()‎]]</code>: تحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى حروف كبيرة (upper-case).
+*التابع <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()‎ في توثيق أردوينو الرسمي.]
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/tochararray/ صفحة التابع toCharArray()‎ في توثيق أردوينو الرسمي.]
 [[تصنيف: Arduino]]
 [[تصنيف: Arduino Method]]
 [[تصنيف: Arduino String]]