الفرق بين المراجعتين لصفحة: «Arduino/serial/readstring»

من موسوعة حسوب
أنشأ الصفحة ب'تقرأ الدالة <code>readString()‎</code> المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. سيُن...'
 
طلا ملخص تعديل
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
تقرأ الدالة <code>readString()‎</code> المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. سيُنهَى عمل الدالة <code>readString()‎</code> إن انتهت المهلة الزمنية (اطلع على الدالة <code>setTimeout()‎</code>).
<noinclude>{{DISPLAYTITLE:التابع <code>Serial.readString()‎</code> في أردوينو}}</noinclude>
يقرأ التابع <code>readString()‎</code> المحارف المستلمة من الاتصال التسلسلي ويعيدها كسلسلة نصية. سيُنهَى عمل التابع <code>readString()‎</code> إن انتهت المهلة الزمنية (اطلع على التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>).


إن عثرت الدالة <code>readBytesUntil()‎</code> على محرف الإنهاء المُمرَّر إليها، فستضع جميع المحارف التي قرأتها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة) في المخزَّن المحدَّد.
يرث التابع <code>readString()‎</code> من الصنف <code>[[Arduino/stream|Stream]]</code>.
 
ترث الدالة <code>readString()‎</code> من الصنف <code>[[Arduino/stream|Stream]]</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="arduino">
<syntaxhighlight lang="arduino">
سطر 10: سطر 9:
==القيم المعادة==
==القيم المعادة==
تعاد سلسلة نصية تحوي المحارف المقروءة من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.
تعاد سلسلة نصية تحوي المحارف المقروءة من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.
 
==انظر أيضًا==
== انظر أيضًا ==
*التابع <code>[[Arduino/serial/available|available()‎]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
 
*التابع <code>[[Arduino/serial/find|find()‎]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
*التابع <code>[[Arduino/serial/read|read()‎]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/readbytes|readBytes()‎]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). 
*التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/write|write()‎]]</code>: يكتب بيانات ثنائية على منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
==مصادر==
==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/readstring/ صفحة الدالة Serial.readString()‎ في توثيق أردوينو الرسمي.]
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/readstring/ صفحة التابع Serial.readString()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino Communication]]
[[تصنيف: Arduino Serial]]

المراجعة الحالية بتاريخ 18:17، 6 نوفمبر 2018

يقرأ التابع readString()‎ المحارف المستلمة من الاتصال التسلسلي ويعيدها كسلسلة نصية. سيُنهَى عمل التابع readString()‎ إن انتهت المهلة الزمنية (اطلع على التابع setTimeout()‎).

يرث التابع readString()‎ من الصنف Stream.

البنية العامة

Serial.readString()

القيم المعادة

تعاد سلسلة نصية تحوي المحارف المقروءة من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.

انظر أيضًا

  • التابع available()‎: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
  • التابع find()‎: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
  • التابع read()‎: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
  • التابع readBytes()‎: يقرأ البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). 
  • التابع setTimeout()‎: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
  • التابع write()‎: يكتب بيانات ثنائية على منفذ الاتصال التسلسلي.
  • التابع serialEvent()‎: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر