Arduino/serial/readbytesuntil

تقرأ الدالة readBytesUntil()‎ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). سيُنهَى عمل الدالة readBytes()‎ إن عُثِر على محرف الإنهاء المُمرَّر إليها، أو قُرِئت البايتات المحدِّدة دون مصادفة محرف الإنهاء، أو انتهت المهلة الزمنية (اطلع على الدالة setTimeout()‎).

إن عثرت الدالة readBytesUntil()‎ على محرف الإنهاء المُمرَّر إليها، فستضع جميع المحارف التي قرأتها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد.

ترث الدالة readBytesUntil()‎ من الصنف Stream.

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

Serial.readBytesUntil(character, buffer, length)

المعاملات

character

محرف يمثِّل محرف إنهاءٍ لعملية القراءة.

buffer

مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (char[]‎ أو byte[]‎).

length

عدد صحيح يمثِّل عدد البايتات المراد قراءتها.

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

يعاد عدد المحارف التي قرئت وخزِّنت في المخزن buffer.

مصادر

• صفحة الدالة Serial.readBytesUntil()‎ في توثيق أردوينو الرسمي.