الدالة Serial.readBytes()‎ في أردوينو

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

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

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

Serial.readBytes(buffer, length)

المعاملات

buffer

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

length

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

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

يعاد عدد البايتات المقروء والمخزَّنة في المخزن buffer.

انظر أيضًا

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

مصادر

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