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

تتحقَّق الدالة findUntil()‎ من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.

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

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

Serial.findUntil(target, terminal)

المعاملات

target

السلسلة النصية المراد البحث عنها والتحقُّق من استلامها عبر الاتصال التسلسلي.

terminal

السلسلة النصية التي تمثِّل حد نهاية عملية البحث ضمن ذاكرة التخزين المؤقتة للاتصال التسلسلي.

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

تعاد القيمة ture إن كان المعامل target موجودًا في الجزء المحدَّد ببداية ذاكرة التخزين المؤقتة للاتصال التسلسلي والمعامل terminal، أو القيمة false إن لم يُعثَر عليه ضمن ذلك الجزء أو انتهت المهلة الزمنية.

انظر أيضًا

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

مصادر

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