الفرق بين المراجعتين لصفحة: «Arduino/serial/readbytes»
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط إضافة محتويات الصفحة. |
||
| سطر 1: | سطر 1: | ||
تقرأ الدالة <code>readBytes()</code> البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). سيُنهَى عمل الدالة <code>readBytes()</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/find|find()]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. | |||
* الدالة <code>[[Arduino/serial/find|find()]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن | *الدالة <code>[[Arduino/serial/parseint|parseInt()]]</code>: تعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. | ||
*الدالة <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/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 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(): تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.