عرض مصدر Arduino/stream/streamparseint

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

هذه الدالة هي جزءٌ من الصنف <code>[[Arduino/stream|Stream]]</code>، وتُستدعَى عبر أي صنف يرث من هذا الصنف (مثل <code>[[Arduino/wire|Wire]]</code>، و <code>[[Arduino/serial|Serial]]</code> ...إلخ.). اطلع على الصفحة الرئيسية للصنف <code>[[Arduino/stream|Stream]]</code> لمزيد من المعلومات.
==البنية العامة==
<syntaxhighlight lang="arduino">
stream.parseInt(list)

stream.parseInt(''list', char skipchar')
</syntaxhighlight>يمثِّل <code>stream</code> نسخةً من الصنف الذي يرث من الصنف <code>[[Arduino/stream|Stream]]</code>.

==المعاملات==

=== <code>list</code> ===
محرفٌ يمثِّل المجرى المراد البحث ضمنه عن [[Arduino/int|أعداد صحيحة]].

===<code>skipChar</code>===
محرفٌ يراد تخطيه أثناء عملية البحث. يُستعمَل هذا المعامل لتخطي فاصلة الآلاف مثلًا.
==القيم المعادة==
يعاد [[Arduino/long|عدد طويل]] يمثِّل العدد الصحيح الصالح التالي الموجود في البيانات المستلمة من المجرى <code>stream</code>، أو تعاد القيمة 0 إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية.
==انظر أيضًا==
* الدالة <code>[[Arduino/stream/streamavailable|available()‎]]</code>: تجلب عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة.
* الدالة <code>[[Arduino/stream/streamread|read()‎]]</code>: تقرأ البيانات المستلمة من المجرى.
* الدالة <code>[[Arduino/stream/streamflush|flush()‎]]</code>: تمسح المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى.
* الدالة <code>[[Arduino/stream/streamfind|find()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن البيانات المستلمة من المجرى.
* الدالة <code>[[Arduino/stream/streamfinduntil|findUntil()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من البيانات المستلمة من المجرى.
* الدالة <code>[[Arduino/stream/streampeek|peek()‎]]</code>: تعيد بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت.
* الدالة <code>[[Arduino/stream/streamreadbytes|readBytes()]]‎</code>: تقرأ البيانات المستلمة من المجرى وتضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer).
* الدالة <code>[[Arduino//stream/streamreadbytesuntil|readBytesUntil()]]‎</code>: تقرأ جزءًا محدَّدًا من البيانات المستلمة من المجرى وتضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer).
* الدالة <code>[[Arduino/stream/streamreadstring|readString()‎]]</code>: تقرأ المحارف المستلمة من المجرى وتعيدها كسلسلة نصية.
* الدالة <code>[[Arduino/stream/streamreadstringuntil|readStringUntil()]]‎</code>: تقرأ جزءًا من المحارف المستلمة من المجرى وتعيدها كسلسلة نصية.
* الدالة <code>[[Arduino/stream/streamparsefloat|parseFloat()‎]]</code>: تعيد أول [[Arduino/float|عدد عشري]] صالح من من الموضع الحالي للمجرى.
* الدالة <code>[[Arduino/stream/streamsettimeout|setTimeout()‎]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.

==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/communication/stream/streamparseint/ صفحة الدالة Stream.parseInt()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Function]]
[[تصنيف: Arduino Communication]]
[[تصنيف: Arduino Stream]]