الفرق بين المراجعتين لصفحة: «Arduino/stream/streamparseint»
جميل-بيلوني (نقاش | مساهمات) إضافة محتويات الصفحة. |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <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"> | <syntaxhighlight lang="arduino"> | ||
| سطر 20: | سطر 20: | ||
يعاد [[Arduino/long|عدد طويل]] يمثِّل العدد الصحيح الصالح التالي الموجود في البيانات المستلمة من المجرى <code>stream</code>، أو تعاد القيمة 0 إن لم يُقرَأ أي عدد صالح عند انتهاء المهلة الزمنية. | يعاد [[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/ صفحة | *[https://www.arduino.cc/reference/en/language/functions/communication/stream/streamparseint/ صفحة التابع Stream.parseInt() في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
[[تصنيف: Arduino | [[تصنيف: Arduino Method]] | ||
[[تصنيف: Arduino Communication]] | [[تصنيف: Arduino Communication]] | ||
[[تصنيف: Arduino Stream]] | [[تصنيف: Arduino Stream]] | ||
المراجعة الحالية بتاريخ 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(): يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.