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

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

يحول التابع toInt()‎ السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم.

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

string.toInt()

تمثِّل string السلسلة النصية المراد تحويلها إلى عددٍ صحيحٍ.

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

يعاد عددٌ طويلٌ يمثِّل ناتج تحويل السلسلة النصية المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ السلسلة النصية تلك لا تبدأ بعددٍ صحيحٍ صالح، فسيُعاد العدد 0 آنذاك.

أمثلة

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

String stringValue1 = "12wiki Hsoub";
String stringValue2 = "wiki12Hsoub";
void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.println(stringValue1.toInt()); // 12
  Serial.println(stringValue2.toInt()); // 0
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:التابع <code>String.toInt()‎</code> في أردوينو}}</noinclude>
-تحول الدالة <code>toInt()‎</code> [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى [[Arduino/int|عددٍ صحيحٍ]]. يجب على [[Arduino/stringobject|السلسلة النصية]] المراد تحويلها أن تبدأ برقم.
+يحول التابع <code>toInt()‎</code> [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/int|عددٍ صحيحٍ]]. يجب على [[Arduino/stringobject|السلسلة النصية]] المراد تحويلها أن تبدأ برقم.
 ==البنية العامة==
 <syntaxhighlight lang="arduino">
@@ سطر 7: / سطر 6: @@
 </syntaxhighlight>تمثِّل <code>string</code> [[Arduino/stringobject|السلسلة النصية]] المراد تحويلها إلى [[Arduino/int|عددٍ صحيحٍ]].
 ==القيم المعادة==
 يعاد [[Arduino/long|عددٌ طويلٌ]] يمثِّل ناتج تحويل [[Arduino/stringobject|السلسلة النصية]] المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ [[Arduino/stringobject|السلسلة النصية]] تلك لا تبدأ [[Arduino/int|بعددٍ صحيحٍ]] صالح، فسيُعاد العدد 0 آنذاك.
+==أمثلة==
+مثال على استعمال التابع <code>toInt()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue1 = "12wiki Hsoub";
+String stringValue2 = "wiki12Hsoub";
+void setup() {
+  Serial.begin(9600);
+}
+void loop() {
+  Serial.println(stringValue1.toInt()); // 12
+  Serial.println(stringValue2.toInt()); // 0
+}
+</syntaxhighlight>
 ==انظر أيضًا==
-* الدالة <code>[[Arduino/string/tochararray|toCharArray()‎]]</code>: تحول كامل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها أو جزءًا منها إلى [[Arduino/string|سلسلة نصية]] مكونة من مصفوفة من المحارف.
+*التابع <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/tochararray|toCharArray()‎]]</code>: يحول كامل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه أو جزءًا منها إلى [[Arduino/string|سلسلة نصية]] مكونة من مصفوفة من المحارف.
-* الدالة <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/toint/ صفحة الدالة toInt()‎ في توثيق أردوينو الرسمي.]
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/toint/ صفحة التابع toInt()‎ في توثيق أردوينو الرسمي.]
 [[تصنيف: Arduino]]
 [[تصنيف: Arduino Method]]
 [[تصنيف: Arduino String]]