الفرق بين المراجعتين لصفحة: «Arduino/stream»
< Arduino
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:المجاري في أردوينو}}</noinclude> | <noinclude>{{DISPLAYTITLE:المجاري في أردوينو}}</noinclude> | ||
الصنف <code>Stream</code> هو الصنف الأساس للمجاري التي تنقل المحارف والبيانات الثنائية. لا يستدعَى هذا الصنف مباشرةً ولكنَّه يُستدعَى كلما | الصنف <code>Stream</code> هو الصنف الأساس للمجاري التي تنقل المحارف والبيانات الثنائية. لا يستدعَى هذا الصنف مباشرةً ولكنَّه يُستدعَى كلما استُعملَ أو استدعيَ تابعٌ يعتمد عليه. | ||
يعرِّف الصنف <code>Stream</code> دوال القراءة في أردوينو. عند استعمال أية وظيفة أساسية تستعمل | يعرِّف الصنف <code>Stream</code> دوال القراءة في أردوينو. عند استعمال أية وظيفة أساسية تستعمل تابعً مثل <code>read()</code> أو أي تابع مشابه، فيمكنك افتراض أنه سيستدعي الصنف <code>Stream</code>. من أجل دوال مثل <code>print()</code>، يرث الصنف <code>Stream</code> آنذاك من الصنف <code>[[Arduino/print|Print]]</code>. | ||
بعض المكتبات التي تعتمد على الصنف <code>Stream</code>: | بعض المكتبات التي تعتمد على الصنف <code>Stream</code>: | ||
| سطر 11: | سطر 11: | ||
==<code>[[Arduino/stream/streamavailable|available()]]</code>== | ==<code>[[Arduino/stream/streamavailable|available()]]</code>== | ||
يجلب التابع عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة. | |||
==<code>[[Arduino/stream/streamread|read()]]</code>== | ==<code>[[Arduino/stream/streamread|read()]]</code>== | ||
يقرأ التابع البيانات المستلمة من المجرى. | |||
==<code>[[Arduino/stream/streamflush|flush()]]</code>== | ==<code>[[Arduino/stream/streamflush|flush()]]</code>== | ||
يمسح التابع المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى. | |||
==<code>[[Arduino/stream/streamfind|find()]]</code>== | ==<code>[[Arduino/stream/streamfind|find()]]</code>== | ||
يتحقَّق التابع من وجود السلسلة النصية المُمرَّرة إليها ضمن البيانات المستلمة من المجرى. | |||
== <code>[[Arduino/stream/streamfinduntil|findUntil()]]</code> == | == <code>[[Arduino/stream/streamfinduntil|findUntil()]]</code> == | ||
يتحقَّق التابع من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من البيانات المستلمة من المجرى. | |||
==<code>[[Arduino/stream/streampeek|peek()]]</code>== | ==<code>[[Arduino/stream/streampeek|peek()]]</code>== | ||
يعيد التابع بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت. | |||
==<code>[[Arduino/stream/streamreadbytes|readBytes()]]</code>== | ==<code>[[Arduino/stream/streamreadbytes|readBytes()]]</code>== | ||
يقرأ التابع البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). | |||
==<code>[[Arduino//stream/streamreadbytesuntil|readBytesUntil()]]</code>== | ==<code>[[Arduino//stream/streamreadbytesuntil|readBytesUntil()]]</code>== | ||
يقرأ التابع جزءًا محدَّدًا من البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). | |||
==<code>[[Arduino/stream/streamreadstring|readString()]]</code>== | ==<code>[[Arduino/stream/streamreadstring|readString()]]</code>== | ||
يقرأ التابع المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. | |||
==<code>[[Arduino/stream/streamreadstringuntil|readStringUntil()]]</code>== | ==<code>[[Arduino/stream/streamreadstringuntil|readStringUntil()]]</code>== | ||
يقرأ التابع جزءًا من المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. | |||
==<code>[[Arduino/stream/streamparseint|parseInt()]]</code>== | ==<code>[[Arduino/stream/streamparseint|parseInt()]]</code>== | ||
يعيد التابع أول [[Arduino/int|عدد صحيح]] (أو [[Arduino/long|طويل]]) صالح من الموضع الحالي للمجرى. | |||
==<code>[[Arduino/stream/streamparsefloat|parseFloat()]]</code>== | ==<code>[[Arduino/stream/streamparsefloat|parseFloat()]]</code>== | ||
يعيد التابع أول [[Arduino/float|عدد عشري]] صالح من من الموضع الحالي للمجرى. | |||
==<code>[[Arduino/stream/streamsettimeout|setTimeout()]]</code>== | ==<code>[[Arduino/stream/streamsettimeout|setTimeout()]]</code>== | ||
يضبط التابع المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى. | |||
== مصادر == | == مصادر == | ||
* [https://www.arduino.cc/reference/en/language/functions/communication/stream/ | * [https://www.arduino.cc/reference/en/language/functions/communication/stream/ صفحة stream في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
[[تصنيف: Arduino Library]] | [[تصنيف: Arduino Library]] | ||
[[تصنيف: Arduino Communication]] | [[تصنيف: Arduino Communication]] | ||
[[تصنيف: Arduino Stream]] | [[تصنيف: Arduino Stream]] | ||
المراجعة الحالية بتاريخ 20:32، 6 نوفمبر 2018
الصنف Stream هو الصنف الأساس للمجاري التي تنقل المحارف والبيانات الثنائية. لا يستدعَى هذا الصنف مباشرةً ولكنَّه يُستدعَى كلما استُعملَ أو استدعيَ تابعٌ يعتمد عليه.
يعرِّف الصنف Stream دوال القراءة في أردوينو. عند استعمال أية وظيفة أساسية تستعمل تابعً مثل read() أو أي تابع مشابه، فيمكنك افتراض أنه سيستدعي الصنف Stream. من أجل دوال مثل print()، يرث الصنف Stream آنذاك من الصنف Print.
بعض المكتبات التي تعتمد على الصنف Stream:
available()
يجلب التابع عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة.
read()
يقرأ التابع البيانات المستلمة من المجرى.
flush()
يمسح التابع المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى.
find()
يتحقَّق التابع من وجود السلسلة النصية المُمرَّرة إليها ضمن البيانات المستلمة من المجرى.
findUntil()
يتحقَّق التابع من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من البيانات المستلمة من المجرى.
peek()
يعيد التابع بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت.
readBytes()
يقرأ التابع البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer).
readBytesUntil()
يقرأ التابع جزءًا محدَّدًا من البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer).
readString()
يقرأ التابع المحارف المستلمة من المجرى ويعيدها كسلسلة نصية.
readStringUntil()
يقرأ التابع جزءًا من المحارف المستلمة من المجرى ويعيدها كسلسلة نصية.
parseInt()
يعيد التابع أول عدد صحيح (أو طويل) صالح من الموضع الحالي للمجرى.
parseFloat()
يعيد التابع أول عدد عشري صالح من من الموضع الحالي للمجرى.
setTimeout()
يضبط التابع المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.