الفرق بين المراجعتين لصفحة: «Arduino/serial/readbytes»

المراجعة الحالية بتاريخ 18:17، 6 نوفمبر 2018

يقرأ التابع readBytes()‎ البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). سيُنهَى عمل التابع readBytes()‎ إن قُرِئت البايتات المحدِّدة أو انتهت المهلة الزمنية (اطلع على التابع setTimeout()‎).

يرث التابع readBytes()‎ من الصنف Stream.

البنية العامة

Serial.readBytes(buffer, length)

المعاملات

`buffer`

مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (char[]‎ أو byte[]‎).

`length`

عدد صحيح يمثِّل عدد البايتات المراد قراءتها.

القيم المعادة

يعاد عدد البايتات المقروء والمخزَّنة في المخزن buffer.

انظر أيضًا

التابع if(Serial)‎: يتحقَّق إن كان المنفذ Serial التسلسلي المُمرَّر إليه جاهزًا للاستعمال.
التابع available()‎: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
التابع find()‎: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
التابع parseInt()‎: يعيد أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت.
التابع read()‎: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
التابع readBytesUntil()‎: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer).
التابع readString()‎: يقرأ المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
التابع readStringUntil()‎: يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
التابع setTimeout()‎: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
التابع serialEvent()‎: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر

صفحة التابع Serial.readBytes()‎ في توثيق أردوينو الرسمي.

@@ سطر 1: / سطر 1: @@
-تقرأ الدالة <code>readBytes()‎</code> البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). سيُنهَى عمل الدالة <code>readBytes()‎</code> إن قُرِئت البايتات المحدِّدة أو انتهت المهلة الزمنية (اطلع على الدالة <code>setTimeout()‎</code>).
+<noinclude>{{DISPLAYTITLE:التابع <code>Serial.readBytes()‎</code> في أردوينو}}</noinclude>
+يقرأ التابع <code>readBytes()‎</code> البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). سيُنهَى عمل التابع <code>readBytes()‎</code> إن قُرِئت البايتات المحدِّدة أو انتهت المهلة الزمنية (اطلع على التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>).
-ترث الدالة <code>readBytes()‎</code> من الصنف <code>[[Arduino/stream|Stream]]</code>.
+يرث التابع <code>readBytes()‎</code> من الصنف <code>[[Arduino/stream|Stream]]</code>.
 ==البنية العامة==
 <syntaxhighlight lang="arduino">
 Serial.readBytes(buffer, length)
 </syntaxhighlight>
+==المعاملات==
-== المعاملات ==
+===<code>buffer</code>===
-=== <code>buffer</code> ===
 مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (<code>[[Arduino/char|char[]‎]]</code> أو <code>[[Arduino/byte|byte[]‎]]</code>).
+===<code>length</code>===
-=== <code>length</code> ===
 [[Arduino/int|عدد صحيح]] يمثِّل عدد البايتات المراد قراءتها.
 ==القيم المعادة==
 يعاد عدد البايتات المقروء والمخزَّنة في المخزن <code>buffer</code>.
+==انظر أيضًا==
-== انظر أيضًا ==
+*التابع <code>[[Arduino/serial/ifserial|if(Serial)‎]]</code>: يتحقَّق إن كان المنفذ <code>Serial</code> التسلسلي المُمرَّر إليه جاهزًا للاستعمال.
+*التابع <code>[[Arduino/serial/available|available()‎]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
+*التابع <code>[[Arduino/serial/find|find()‎]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
+*التابع <code>[[Arduino/serial/parseint|parseInt()‎]]</code>: يعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
+*التابع <code>[[Arduino/serial/read|read()‎]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
+*التابع <code>[[Arduino/serial/readbytesuntil|readBytesUntil()‎]]</code>: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer).
+*التابع <code>[[Arduino/serial/readstring|readString()‎]]</code>: يقرأ المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
+*التابع <code>[[Arduino/serial/readstringuntil|readStringUntil()‎]]</code>: يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
+*التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
+*التابع <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
 ==مصادر==
-*[https://www.arduino.cc/reference/en/language/functions/communication/serial/readbytes/ صفحة الدالة Serial.readBytes()‎ في توثيق أردوينو الرسمي.]
+*[https://www.arduino.cc/reference/en/language/functions/communication/serial/readbytes/ صفحة التابع Serial.readBytes()‎ في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Method]]
+[[تصنيف: Arduino Communication]]
+[[تصنيف: Arduino Serial]]