عرض مصدر Arduino/serial/readstringuntil

<noinclude>{{DISPLAYTITLE:التابع <code>Serial.readStringUntil()‎</code> في أردوينو}}</noinclude>
يقرأ التابع <code>readStringUntil()‎</code> جزءًا من المحارف المستلمة من الاتصال التسلسلي ويعيدها كسلسلة نصية. سيُنهَى عمل التابع <code>readStringUntil()‎</code> إن عُثِر على محرف الإنهاء المُمرَّر إليه أو انتهت المهلة الزمنية (اطلع على التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>).

إن عُثِر التابع <code>readStringUntil()‎</code> على محرف الإنهاء المُمرَّر إليه، فسيعيد جميع المحارف التي قرأها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة).

يرث التابع <code>readStringUntil()‎</code> من الصنف <code>[[Arduino/stream|Stream]]</code>.
==البنية العامة==
<syntaxhighlight lang="arduino">
Serial.readStringUntil(terminator)
</syntaxhighlight>
==المعاملات==
===<code>terminator</code>===
محرف يمثِّل محرف إنهاءٍ لعملية القراءة.
==القيم المعادة==
تعاد سلسلة نصية تحوي المحارف المقروءة حتى المحرف <code>terminator</code> (إن عُثِر عليه) من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.
==انظر أيضًا==
*التابع <code>[[Arduino/serial/available|available()‎]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/finduntil|findUntil()‎]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
*التابع <code>[[Arduino/serial/parsefloat|parseFloat()‎]]</code>: يعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
*التابع <code>[[Arduino/serial/peek|peek()‎]]</code>: يعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي.
*التابع <code>[[Arduino/serial/readbytesuntil|readBytesUntil()‎]]</code>: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer).
*التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/readstringuntil/ صفحة التابع Serial.readStringUntil()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino Communication]]
[[تصنيف: Arduino Serial]]