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

مصادر