الدالة Serial.parseInt()‎ في أردوينو

من موسوعة حسوب

تعيد الدالة parseInt()‎ أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت. تُتخطَى المحارف التي ليست أرقامًا أو إشارة سالبة. يُنهَى عمل الدالة parseInt()‎ إن لم يُعثَر على أي محرف لقراءته خلال فترة زمنية معيَّنة (يمكن ضبطها)، أو لم يُعثَر بين المحارف على أي رقم. إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية (اطلع على الدالة setTimeout()‎)، فسيُعاد العدد 0.

ترث الدالة parseInt()‎ من الصنف stream.

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

Serial.parseInt()
Serial.parseInt(char skipChar)

// فقط Mega لوحات أردوينو
Serial1.parseInt()
Serial2.parseInt()
Serial3.parseInt()

المعاملات

skipChar

محرفٌ يراد تخطيه أثناء عملية البحث. يُستعمَل هذا المعامل لتخطي فاصلة الآلاف مثلًا.

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

يعاد عدد طويل يمثِّل العدد الصحيح الصالح التالي الموجود في البيانات المستلمة من الاتصال التسلسلي والمخزَّنة في الذاكرة المؤقتة، أو تعاد القيمة 0 إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية.

انظر أيضًا

  • الدالة find()‎: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
  • الدالة findUntil()‎: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
  • الدالة parseFloat()‎: تعيد أول عدد عشري صالح من مخزَّن الاتصال التسلسلي المؤقت.
  • الدالة read()‎: تقرأ البيانات المستلمة عبر الاتصال التسلسلي.
  • الدالة readBytesUntil()‎: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer).
  • الدالة readString()‎: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
  • الدالة readStringUntil()‎: تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
  • الدالة setTimeout()‎: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
  • الدالة serialEvent()‎: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر