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

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