الفرق بين المراجعتين ل"Arduino/serial/parseint"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: | + | <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>. | |
==البنية العامة== | ==البنية العامة== | ||
<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>: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي | + | *التابع <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 | + | [[تصنيف: 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(): يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.