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

من موسوعة حسوب
أنشأ الصفحة ب'تقرأ الدالة <code>readString()‎</code> المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. سيُن...'
 
لا ملخص تعديل
سطر 1: سطر 1:
تقرأ الدالة <code>readString()‎</code> المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. سيُنهَى عمل الدالة <code>readString()‎</code> إن انتهت المهلة الزمنية (اطلع على الدالة <code>setTimeout()‎</code>).
تقرأ الدالة <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>.
سطر 10: سطر 8:
==القيم المعادة==
==القيم المعادة==
تعاد سلسلة نصية تحوي المحارف المقروءة من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.
تعاد سلسلة نصية تحوي المحارف المقروءة من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.
 
==انظر أيضًا==
== انظر أيضًا ==
* الدالة <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()‎ في توثيق أردوينو الرسمي.]

مراجعة 07:41، 22 أكتوبر 2018

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

ترث الدالة readString()‎ من الصنف Stream.

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

Serial.readString()

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

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

انظر أيضًا

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

مصادر