الفرق بين المراجعتين ل"Arduino/serial/readbytes"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (أنشأ الصفحة ب'تقرأ الدالة <code>readBytes()</code> البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخ...') |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | + | <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>. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
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/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/ صفحة | + | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/readbytes/ صفحة التابع Serial.readBytes() في توثيق أردوينو الرسمي.] |
| + | [[تصنيف: Arduino]] | ||
| + | [[تصنيف: Arduino Method]] | ||
| + | [[تصنيف: Arduino Communication]] | ||
| + | [[تصنيف: Arduino Serial]] | ||
المراجعة الحالية بتاريخ 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(): يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.