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