Arduino/stream/streamreadbytesuntil

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

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

هذا التابع هو جزءٌ من الصنف Stream، ويُستدعَى عبر أي صنف يرث من هذا الصنف (مثل Wire، و Serial ...إلخ.). اطلع على الصفحة الرئيسية للصنف Stream لمزيد من المعلومات.

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

stream.readBytesUntil(character, buffer, length)

يمثِّل stream نسخةً من الصنف الذي يرث من الصنف Stream.

المعاملات

character

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

buffer

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

length

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

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

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

انظر أيضًا

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

مصادر

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