التابع Serial.readBytesUntil()‎ في أردوينو

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

يقرأ التابع 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()‎: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر