الفرق بين المراجعتين ل"Arduino/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>.
سطر 14: سطر 15:
 
يعاد عدد البايتات المقروء والمخزَّنة في المخزن <code>buffer</code>.
 
يعاد عدد البايتات المقروء والمخزَّنة في المخزن <code>buffer</code>.
 
==انظر أيضًا==
 
==انظر أيضًا==
* الدالة <code>[[Arduino/serial/ifserial|if(Serial)‎]]</code>: تتحقَّق إن كان المنفذ <code>Serial</code> التسلسلي المُمرَّر إليها جاهزًا للاستعمال.
+
*الدالة <code>[[Arduino/serial/ifserial|if(Serial)‎]]</code>: تتحقَّق إن كان المنفذ <code>Serial</code> التسلسلي المُمرَّر إليها جاهزًا للاستعمال.
* الدالة <code>[[Arduino/serial/available|available()‎]]</code>: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
+
*الدالة <code>[[Arduino/serial/available|available()‎]]</code>: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
* الدالة <code>[[Arduino/serial/begin|begin()‎]]</code>: تضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي.
+
*الدالة <code>[[Arduino/serial/find|find()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
* الدالة <code>[[Arduino/serial/find|find()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
+
*الدالة <code>[[Arduino/serial/parseint|parseInt()‎]]</code>: تعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
* الدالة <code>[[Arduino/serial/finduntil|findUntil()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
+
*الدالة <code>[[Arduino/serial/read|read()‎]]</code>: تقرأ البيانات المستلمة عبر الاتصال التسلسلي.
* الدالة <code>[[Arduino/serial/parseint|parseInt()‎]]</code>: تعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
+
*الدالة <code>[[Arduino/serial/readbytesuntil|readBytesUntil()‎]]</code>: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer).
* الدالة <code>[[Arduino/serial/read|read()‎]]</code>: تقرأ البيانات المستلمة عبر الاتصال التسلسلي.
+
*الدالة <code>[[Arduino/serial/readstring|readString()‎]]</code>: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
* الدالة <code>[[Arduino/serial/readbytesuntil|readBytesUntil()‎]]</code>: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer).
+
*الدالة <code>[[Arduino/serial/readstringuntil|readStringUntil()‎]]</code>: تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
* الدالة <code>[[Arduino/serial/readstring|readString()‎]]</code>: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
+
*الدالة <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
* الدالة <code>[[Arduino/serial/readstringuntil|readStringUntil()‎]]</code>: تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
+
*الدالة <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
* الدالة <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
 
* الدالة <code>[[Arduino/serial/write|write()‎]]</code>: تكتب بيانات ثنائية على منفذ الاتصال التسلسلي.
 
* الدالة <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
 
 
 
 
==مصادر==
 
==مصادر==
<span> </span>
 
 
*[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 Function]]
 +
[[تصنيف: Arduino Communication]]
 +
[[تصنيف: Arduino Serial]]

مراجعة 09:59، 22 أكتوبر 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()‎: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر