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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-تعيد الدالة <code>parseFloat()‎</code> أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. تُتخطَى المحارف التي ليست أرقامًا أو إشارة سالبة. يُنهَى عمل الدالة <code>parseFloat()‎</code> إن لم يُعثَر على أي محرف لقراءته خلال فترة زمنية معيَّنة (يمكن ضبطها)، أو لم يُعثَر بين المحارف على أي رقم. إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية (اطلع على الدالة <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>)، فسيُعاد العدد 0.
+<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> من الصنف <code>[[Arduino/stream|stream]]</code>.
@@ سطر 12: / سطر 13: @@
 Serial3.parseInt()
 </syntaxhighlight>
+==المعاملات==
-== المعاملات ==
+===<code>skipChar</code>===
+محرفٌ يراد تخطيه أثناء عملية البحث. يُستعمَل هذا المعامل لتخطي فاصلة الآلاف مثلًا.
-=== <code>skipChar</code> ===
-محرف يراد تخطيه أثناء عملية البحث. يُستعمَل هذا المعامل لتخطي فاصلة الآلاف مثلًا.
 ==القيم المعادة==
 يعاد [[Arduino/long|عدد طويل]] يمثِّل العدد العشري الصالح التالي الموجود في البيانات المستلمة من الاتصال التسلسلي والمخزَّنة في الذاكرة المؤقتة، أو تعاد القيمة 0 إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية.
 ==انظر أيضًا==
+*الدالة <code>[[Arduino/serial/find|find()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
+*الدالة <code>[[Arduino/serial/finduntil|findUntil()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
+*الدالة <code>[[Arduino/serial/parsefloat|parseFloat()‎]]</code>: تعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
+*الدالة <code>[[Arduino/serial/read|read()‎]]</code>: تقرأ البيانات المستلمة عبر الاتصال التسلسلي.
+*الدالة <code>[[Arduino/serial/readbytesuntil|readBytesUntil()‎]]</code>: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer).
+*الدالة <code>[[Arduino/serial/readstring|readString()‎]]</code>: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
+*الدالة <code>[[Arduino/serial/readstringuntil|readStringUntil()‎]]</code>: تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
+*الدالة <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
+*الدالة <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
 ==مصادر==
 *[https://www.arduino.cc/reference/en/language/functions/communication/serial/parseint/ صفحة الدالة Serial.parseInt()‎ في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Function]]
+[[تصنيف: Arduino Communication]]
+[[تصنيف: Arduino Serial]]