الدالة Stream.readBytesUntil() في أردوينو
تقرأ الدالة 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(): تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.