الفرق بين المراجعتين لصفحة: «Arduino/serial/readbytes»
جميل-بيلوني (نقاش | مساهمات) أنشأ الصفحة ب'تقرأ الدالة <code>readBytes()</code> البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخ...' |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 6: | سطر 6: | ||
Serial.readBytes(buffer, length) | Serial.readBytes(buffer, length) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | |||
== المعاملات == | ===<code>buffer</code>=== | ||
=== <code>buffer</code> === | |||
مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (<code>[[Arduino/char|char[]]]</code> أو <code>[[Arduino/byte|byte[]]]</code>). | مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (<code>[[Arduino/char|char[]]]</code> أو <code>[[Arduino/byte|byte[]]]</code>). | ||
===<code>length</code>=== | |||
=== <code>length</code> === | |||
[[Arduino/int|عدد صحيح]] يمثِّل عدد البايتات المراد قراءتها. | [[Arduino/int|عدد صحيح]] يمثِّل عدد البايتات المراد قراءتها. | ||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد عدد البايتات المقروء والمخزَّنة في المخزن <code>buffer</code>. | يعاد عدد البايتات المقروء والمخزَّنة في المخزن <code>buffer</code>. | ||
==انظر أيضًا== | |||
== انظر أيضًا == | * الدالة <code>[[Arduino/serial/ifserial|if(Serial)]]</code>: تتحقَّق إن كان المنفذ <code>Serial</code> التسلسلي المُمرَّر إليها جاهزًا للاستعمال. | ||
* الدالة <code>[[Arduino/serial/available|available()]]</code>: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. | |||
* الدالة <code>[[Arduino/serial/begin|begin()]]</code>: تضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي. | |||
* الدالة <code>[[Arduino/serial/find|find()]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. | |||
* الدالة <code>[[Arduino/serial/finduntil|findUntil()]]</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/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() في توثيق أردوينو الرسمي.] | ||
* | |||
مراجعة 07:49، 22 أكتوبر 2018
تقرأ الدالة readBytes() البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). سيُنهَى عمل الدالة readBytes() إن قُرِئت البايتات المحدِّدة أو انتهت المهلة الزمنية (اطلع على الدالة setTimeout()).
ترث الدالة readBytes() من الصنف Stream.
البنية العامة
Serial.readBytes(buffer, length)
المعاملات
buffer
مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (char[] أو byte[]).
length
عدد صحيح يمثِّل عدد البايتات المراد قراءتها.
القيم المعادة
يعاد عدد البايتات المقروء والمخزَّنة في المخزن buffer.
انظر أيضًا
- الدالة
if(Serial): تتحقَّق إن كان المنفذSerialالتسلسلي المُمرَّر إليها جاهزًا للاستعمال. - الدالة
available(): تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. - الدالة
begin(): تضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي. - الدالة
find(): تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - الدالة
findUntil(): تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - الدالة
parseInt(): تعيد أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت. - الدالة
read(): تقرأ البيانات المستلمة عبر الاتصال التسلسلي. - الدالة
readBytesUntil(): تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). - الدالة
readString(): تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. - الدالة
readStringUntil(): تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. - الدالة
setTimeout(): تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - الدالة
write(): تكتب بيانات ثنائية على منفذ الاتصال التسلسلي. - الدالة
serialEvent(): تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
مصادر