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

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

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

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

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

available()‎

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

read()‎

يقرأ التابع البيانات المستلمة من المجرى.

flush()‎

يمسح التابع المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى.

find()‎

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

findUntil()‎

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

peek()‎

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

readBytes()‎

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

readBytesUntil()‎

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

readString()‎

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

readStringUntil()‎

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

parseInt()‎

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

parseFloat()‎

يعيد التابع أول عدد عشري صالح من من الموضع الحالي للمجرى.

setTimeout()‎

يضبط التابع المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.

مصادر