المجاري في أردوينو

من موسوعة حسوب

الصنف Stream هو الصنف الأساس للمجاري التي تنقل المحارف والبيانات الثنائية. لا يستدعَى هذا الصنف مباشرةً ولكنَّه يُستدعَى كلما استُعملَت أو استدعيَت دالةٌ تعتمد عليه.

يعرِّف الصنف Stream دوال القراءة في أردوينو. عند استعمال أية وظيفة أساسية تستعمل دالةً مثل read()‎ أو أي تابع مشابه، فيمكنك افتراض أنه سيستدعي الصنف Stream. من أجل دوال مثل print()‎، يرث الصنف Stream آنذاك من الصنف Print.

بعض المكتبات التي تعتمد على الصنف Stream:

available()‎

تجلب الدالة available()‎ عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة.

read()‎

تقرأ الدالة read()‎ البيانات المستلمة من المجرى.

flush()‎

تمسح الدالة flush()‎ المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى.

find()‎

تتحقَّق الدالة find()‎ من وجود السلسلة النصية المُمرَّرة إليها ضمن البيانات المستلمة من المجرى.

findUntil()‎

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

peek()‎

تعيد الدالة peek()‎ بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت.

readBytes()‎

تقرأ الدالة readBytes()‎ البيانات المستلمة من المجرى وتضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer).

readBytesUntil()‎

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

readString()‎

تقرأ الدالة readString()‎ المحارف المستلمة من المجرى وتعيدها كسلسلة نصية.

readStringUntil()‎

تقرأ الدالة readStringUntil()‎ جزءًا من المحارف المستلمة من المجرى وتعيدها كسلسلة نصية.

parseInt()‎

تعيد الدالة parseInt()‎ أول عدد صحيح (أو طويل) صالح من الموضع الحالي للمجرى.

parseFloat()‎

تعيد الدالة parseFloat()‎ أول عدد عشري صالح من من الموضع الحالي للمجرى.

setTimeout()‎

تضبط الدالة setTimeout()‎ المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.

مصادر