الفرق بين المراجعتين لصفحة: «Arduino/serial/readstringuntil»
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <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"> | <syntaxhighlight lang="arduino"> | ||
Serial.readStringUntil(terminator) | Serial.readStringUntil(terminator) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | |||
== المعاملات == | ===<code>terminator</code>=== | ||
=== <code>terminator</code> === | |||
محرف يمثِّل محرف إنهاءٍ لعملية القراءة. | محرف يمثِّل محرف إنهاءٍ لعملية القراءة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد سلسلة نصية تحوي المحارف المقروءة حتى المحرف <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/ صفحة | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/readstringuntil/ صفحة التابع Serial.readStringUntil() في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
[[تصنيف: Arduino | [[تصنيف: Arduino Method]] | ||
[[تصنيف: Arduino Communication]] | [[تصنيف: Arduino Communication]] | ||
[[تصنيف: Arduino Serial]] | [[تصنيف: Arduino Serial]] | ||
المراجعة الحالية بتاريخ 18:17، 6 نوفمبر 2018
يقرأ التابع readStringUntil() جزءًا من المحارف المستلمة من الاتصال التسلسلي ويعيدها كسلسلة نصية. سيُنهَى عمل التابع readStringUntil() إن عُثِر على محرف الإنهاء المُمرَّر إليه أو انتهت المهلة الزمنية (اطلع على التابع setTimeout()).
إن عُثِر التابع readStringUntil() على محرف الإنهاء المُمرَّر إليه، فسيعيد جميع المحارف التي قرأها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة).
يرث التابع readStringUntil() من الصنف Stream.
البنية العامة
Serial.readStringUntil(terminator)
المعاملات
terminator
محرف يمثِّل محرف إنهاءٍ لعملية القراءة.
القيم المعادة
تعاد سلسلة نصية تحوي المحارف المقروءة حتى المحرف terminator (إن عُثِر عليه) من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.
انظر أيضًا
- التابع
available(): يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. - التابع
findUntil(): يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - التابع
parseFloat(): يعيد أول عدد عشري صالح من مخزَّن الاتصال التسلسلي المؤقت. - التابع
peek(): يعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. - التابع
readBytesUntil(): يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). - التابع
setTimeout(): يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - التابع
serialEvent(): يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.