الفرق بين المراجعتين ل"Arduino/serial/readbytesuntil"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (أنشأ الصفحة ب'تقرأ الدالة <code>readBytesUntil()</code> جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضع...') |
جميل-بيلوني (نقاش | مساهمات) |
||
| سطر 1: | سطر 1: | ||
| − | تقرأ الدالة <code>readBytesUntil()</code> جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). سيُنهَى عمل الدالة <code>readBytes()</code> إن عُثِر على محرف الإنهاء المُمرَّر إليها، أو قُرِئت البايتات المحدِّدة دون مصادفة محرف الإنهاء، أو انتهت المهلة الزمنية (اطلع على الدالة <code>setTimeout()</code>). | + | تقرأ الدالة <code>readBytesUntil()</code> جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). سيُنهَى عمل الدالة <code>readBytes()</code> إن عُثِر على محرف الإنهاء المُمرَّر إليها، أو قُرِئت البايتات المحدِّدة دون مصادفة محرف الإنهاء، أو انتهت المهلة الزمنية (اطلع على الدالة <code>[[Arduino/serial/settimeout|setTimeout()]]</code>). |
إن عثرت الدالة <code>readBytesUntil()</code> على محرف الإنهاء المُمرَّر إليها، فستضع جميع المحارف التي قرأتها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد. | إن عثرت الدالة <code>readBytesUntil()</code> على محرف الإنهاء المُمرَّر إليها، فستضع جميع المحارف التي قرأتها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد. | ||
| سطر 10: | سطر 10: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ==المعاملات== | |
| − | == المعاملات == | + | ===<code>character</code>=== |
| − | + | [[Arduino/byte|محرف]] يمثِّل محرف إنهاءٍ لعملية القراءة. | |
| − | === <code>character</code> === | + | ===<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/available|available()]]</code>: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. |
| + | * الدالة <code>[[Arduino/serial/finduntil|findUntil()]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. | ||
| + | * الدالة <code>[[Arduino/serial/parseint|parseInt()]]</code>: تعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. | ||
| + | * الدالة <code>[[Arduino/serial/peek|peek()]]</code>: تعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. | ||
| + | * الدالة <code>[[Arduino/serial/read|read()]]</code>: تقرأ البيانات المستلمة عبر الاتصال التسلسلي. | ||
| + | * الدالة <code>[[Arduino/serial/readbytes|readBytes()]]</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/readbytesuntil/ صفحة الدالة Serial.readBytesUntil() في توثيق أردوينو الرسمي.] | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/readbytesuntil/ صفحة الدالة Serial.readBytesUntil() في توثيق أردوينو الرسمي.] | ||
مراجعة 07:42، 22 أكتوبر 2018
تقرأ الدالة readBytesUntil() جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). سيُنهَى عمل الدالة readBytes() إن عُثِر على محرف الإنهاء المُمرَّر إليها، أو قُرِئت البايتات المحدِّدة دون مصادفة محرف الإنهاء، أو انتهت المهلة الزمنية (اطلع على الدالة setTimeout()).
إن عثرت الدالة readBytesUntil() على محرف الإنهاء المُمرَّر إليها، فستضع جميع المحارف التي قرأتها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد.
ترث الدالة readBytesUntil() من الصنف Stream.
البنية العامة
Serial.readBytesUntil(character, buffer, length)
المعاملات
character
محرف يمثِّل محرف إنهاءٍ لعملية القراءة.
buffer
مخزنٌ مؤقت ستخزَّن فيه البايتات المقروءة (char[] أو byte[]).
length
عدد صحيح يمثِّل عدد البايتات المراد قراءتها.
القيم المعادة
يعاد عدد المحارف التي قرئت وخزِّنت في المخزن buffer.
انظر أيضًا
- الدالة
available(): تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. - الدالة
findUntil(): تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - الدالة
parseInt(): تعيد أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت. - الدالة
peek(): تعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. - الدالة
read(): تقرأ البيانات المستلمة عبر الاتصال التسلسلي. - الدالة
readBytes(): تقرأ البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). - الدالة
readString(): تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. - الدالة
readStringUntil(): تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. - الدالة
setTimeout(): تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - الدالة
serialEvent(): تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.