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

من موسوعة حسوب
طلا ملخص تعديل
طلا ملخص تعديل
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>Serial.parseInt()‎</code> في أردوينو}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>Serial.parseInt()‎</code> في أردوينو}}</noinclude>
يعيد التابع <code>parseInt()‎</code> أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. تُتخطَى المحارف التي ليست أرقامًا أو إشارة سالبة. يُنهَى عمل التابع <code>parseInt()‎</code> إن لم يُعثَر على أي محرف لقراءته خلال فترة زمنية معيَّنة (يمكن ضبطها)، أو لم يُعثَر بين المحارف على أي رقم. إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية (اطلع على التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>)، فسيُعاد العدد 0.
يعيد التابع <code>parseInt()‎</code> أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. تُتخطَى المحارف التي ليست أرقامًا أو إشارة سالبة. يُنهَى عمل التابع <code>parseInt()‎</code> إن لم يُعثَر على أي محرف لقراءته خلال فترة زمنية معيَّنة (يمكن ضبطها)، أو لم يُعثَر بين المحارف على أي رقم. إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية (اطلع على التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>)، فسيُعاد العدد 0.


ترث التابع <code>parseInt()‎</code> من الصنف <code>[[Arduino/stream|stream]]</code>.
يرث التابع <code>parseInt()‎</code> من الصنف <code>[[Arduino/stream|stream]]</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="arduino">
<syntaxhighlight lang="arduino">
سطر 23: سطر 23:
*التابع <code>[[Arduino/serial/parsefloat|parseFloat()‎]]</code>: يعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
*التابع <code>[[Arduino/serial/parsefloat|parseFloat()‎]]</code>: يعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
*التابع <code>[[Arduino/serial/read|read()‎]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/read|read()‎]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/readbytesuntil|readBytesUntil()‎]]</code>: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer).
*التابع <code>[[Arduino/serial/readbytesuntil|readBytesUntil()‎]]</code>: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer).
*التابع <code>[[Arduino/serial/readstring|readString()‎]]</code>: يقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
*التابع <code>[[Arduino/serial/readstring|readString()‎]]</code>: يقرأ المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
*التابع <code>[[Arduino/serial/readstringuntil|readStringUntil()‎]]</code>: يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
*التابع <code>[[Arduino/serial/readstringuntil|readStringUntil()‎]]</code>: يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
*التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
سطر 31: سطر 31:
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/parseint/ صفحة التابع Serial.parseInt()‎ في توثيق أردوينو الرسمي.]
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/parseint/ صفحة التابع Serial.parseInt()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Function]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino Communication]]
[[تصنيف: Arduino Communication]]
[[تصنيف: Arduino Serial]]
[[تصنيف: Arduino Serial]]

المراجعة الحالية بتاريخ 17:47، 6 نوفمبر 2018

يعيد التابع 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()‎: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر