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

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

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

هذا التابع هو جزءٌ من الصنف Stream، ويُستدعَى عبر أي صنف يرث من هذا الصنف (مثل Wire، و Serial ...إلخ.). اطلع على الصفحة الرئيسية للصنف Stream لمزيد من المعلومات.

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

stream.parseInt(list)

stream.parseInt(''list', char skipchar')

يمثِّل stream نسخةً من الصنف الذي يرث من الصنف Stream.

المعاملات

`list`

محرفٌ يمثِّل المجرى المراد البحث ضمنه عن أعداد صحيحة.

`skipChar`

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

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

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

انظر أيضًا

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

مصادر

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

مراجعة 18:37، 6 نوفمبر 2018 عرض المصدر جميل-بيلوني (نقاش \| مساهمات) بيروقراطيون، مساهمون، إداريون 7٬573 تعديلًا طلا ملخص تعديل وسم: المحرر المرئي: تبديل → التعديل السابق		المراجعة الحالية بتاريخ 19:23، 6 نوفمبر 2018 عرض المصدر جميل-بيلوني (نقاش \| مساهمات) بيروقراطيون، مساهمون، إداريون 7٬573 تعديلًا طلا ملخص تعديل وسم: المحرر المرئي: تبديل
سطر 1:		سطر 1:
	<noinclude>{{DISPLAYTITLE:~~الدالة~~ <code>Stream.parseInt()‎</code> في أردوينو}}</noinclude>		<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>parseInt()‎</code> أول [[Arduino/int\|عدد صحيح]] (أو [[Arduino/long\|طويل]]) صالح من الموضع الحالي للمجرى. تُتخطَى المحارف التي ليست أرقامًا أو إشارةً سالبةً. يُنهَى عمل التابع <code>parseInt()‎</code> إن لم يُعثَر على أي محرف لقراءته خلال فترة زمنية معيَّنة (يمكن ضبطها)، أو لم يُعثَر بين المحارف على أي رقم. إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية (اطلع على التابع <code>[[Arduino/serial/settimeout\|setTimeout()‎]]</code>)، فسيُعاد العدد 0.