التابع 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()‎ في توثيق أردوينو الرسمي.