الفرق بين المراجعتين لصفحة: «Arduino/serial/readbytesuntil»
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Serial.readBytesUntil()</code> في أردوينو}}</noinclude> | |||
يقرأ التابع <code>readBytesUntil()</code> جزءًا محدَّدًا من البيانات المستلمة من الاتصال التسلسلي ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). سيُنهَى عمل التابع <code>readBytesUntil()</code> إن عُثِر على محرف الإنهاء المُمرَّر إليها، أو قُرِئت البايتات المحدِّدة دون مصادفة محرف الإنهاء، أو انتهت المهلة الزمنية (اطلع على التابع <code>[[Arduino/serial/settimeout|setTimeout()]]</code>). | |||
إن | إن عثر التابع <code>readBytesUntil()</code> على محرف الإنهاء المُمرَّر إليه، فسيضع جميع المحارف التي قرأها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد. | ||
يرث التابع <code>readBytesUntil()</code> من الصنف <code>[[Arduino/stream|Stream]]</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
| سطر 20: | سطر 21: | ||
يعاد عدد المحارف التي قرئت وخزِّنت في المخزن <code>buffer</code>. | يعاد عدد المحارف التي قرئت وخزِّنت في المخزن <code>buffer</code>. | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* | *التابع <code>[[Arduino/serial/available|available()]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. | ||
* | *التابع <code>[[Arduino/serial/finduntil|findUntil()]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. | ||
* | *التابع <code>[[Arduino/serial/parseint|parseInt()]]</code>: يعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. | ||
* | *التابع <code>[[Arduino/serial/peek|peek()]]</code>: يعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. | ||
* | *التابع <code>[[Arduino/serial/read|read()]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي. | ||
* | *التابع <code>[[Arduino/serial/readbytes|readBytes()]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). | ||
* | *التابع <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/readbytesuntil/ صفحة | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/readbytesuntil/ صفحة التابع Serial.readBytesUntil() في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | |||
[[تصنيف: Arduino Method]] | |||
[[تصنيف: Arduino Communication]] | |||
[[تصنيف: Arduino Serial]] | |||
المراجعة الحالية بتاريخ 18:17، 6 نوفمبر 2018
يقرأ التابع readBytesUntil() جزءًا محدَّدًا من البيانات المستلمة من الاتصال التسلسلي ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). سيُنهَى عمل التابع readBytesUntil() إن عُثِر على محرف الإنهاء المُمرَّر إليها، أو قُرِئت البايتات المحدِّدة دون مصادفة محرف الإنهاء، أو انتهت المهلة الزمنية (اطلع على التابع setTimeout()).
إن عثر التابع readBytesUntil() على محرف الإنهاء المُمرَّر إليه، فسيضع جميع المحارف التي قرأها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد.
يرث التابع readBytesUntil() من الصنف Stream.
البنية العامة
Serial.readBytesUntil(character, buffer, length)
المعاملات
character
محرف يمثِّل محرف إنهاءٍ لعملية القراءة.
buffer
مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (char[] أو byte[]).
length
عدد صحيح يمثِّل عدد البايتات المراد قراءتها.
القيم المعادة
يعاد عدد المحارف التي قرئت وخزِّنت في المخزن buffer.
انظر أيضًا
- التابع
available(): يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. - التابع
findUntil(): يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - التابع
parseInt(): يعيد أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت. - التابع
peek(): يعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. - التابع
read(): يقرأ البيانات المستلمة عبر الاتصال التسلسلي. - التابع
readBytes(): يقرأ البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). - التابع
readStringUntil(): يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية. - التابع
setTimeout(): يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - التابع
serialEvent(): يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.