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

مصادر

صفحة الدالة Serial.readBytesUntil()‎ في توثيق أردوينو الرسمي.

@@ سطر 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> على محرف الإنهاء المُمرَّر إليها، فستضع جميع المحارف التي قرأتها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد.
@@ سطر 10: / سطر 10: @@
 </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>length</code>===
-=== <code>length</code> ===
 [[Arduino/int|عدد صحيح]] يمثِّل عدد البايتات المراد قراءتها.
 ==القيم المعادة==
 يعاد عدد المحارف التي قرئت وخزِّنت في المخزن <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()‎ في توثيق أردوينو الرسمي.]