التابع Stream.readString()
في أردوينو
< Arduino | stream
اذهب إلى التنقل
اذهب إلى البحث
مراجعة 18:38، 6 نوفمبر 2018 بواسطة جميل-بيلوني (نقاش | مساهمات)
يقرأ التابع readString()
المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. سيُنهَى عمل التابع readString()
إن انتهت المهلة الزمنية (اطلع على التابع setTimeout()
).
هذا التابع هو جزءٌ من الصنف Stream
، ويُستدعَى عبر أي صنف يرث من هذا الصنف (مثل Wire
، و Serial
...إلخ.). اطلع على الصفحة الرئيسية للصنف Stream
لمزيد من المعلومات.
البنية العامة
stream.readString()
يمثِّل stream
نسخةً من الصنف الذي يرث من الصنف Stream
.
القيم المعادة
تعاد سلسلة نصية تحوي المحارف المقروءة من المجرى.
انظر أيضًا
- التابع
available()
: يجلب عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة. - التابع
read()
: يقرأ البيانات المستلمة من المجرى. - التابع
flush()
: يمسح المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى. - التابع
find()
: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن البيانات المستلمة من المجرى. - التابع
findUntil()
: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من البيانات المستلمة من المجرى. - التابع
peek()
: يعيد بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت. - التابع
readBytes()
: يقرأ البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). - التابع
readBytesUntil()
: يقرأ جزءًا محدَّدًا من البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). - التابع
readStringUntil()
: يقرأ جزءًا من المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. - التابع
parseInt()
: يعيد أول عدد صحيح (أو طويل) صالح من الموضع الحالي للمجرى. - التابع
parseFloat()
: يعيد أول عدد عشري صالح من من الموضع الحالي للمجرى. - التابع
setTimeout()
: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.