Arduino/serial/readstring

تقرأ الدالة readString()‎ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. سيُنهَى عمل الدالة readString()‎ إن انتهت المهلة الزمنية (اطلع على الدالة setTimeout()‎).

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

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

Serial.readString()

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

تعاد سلسلة نصية تحوي المحارف المقروءة من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.

انظر أيضًا

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

مصادر

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