الفرق بين المراجعتين ل"Arduino/serial/readstringuntil"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (أنشأ الصفحة ب'تقرأ الدالة <code>readStringUntil()</code> جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسل...') |
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
||
| سطر 1: | سطر 1: | ||
| + | <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/serial/settimeout|setTimeout()]]</code>). | ||
| سطر 23: | سطر 24: | ||
* الدالة <code>[[Arduino/serial/peek|peek()]]</code>: تعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. | * الدالة <code>[[Arduino/serial/peek|peek()]]</code>: تعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. | ||
* الدالة <code>[[Arduino/serial/readbytesuntil|readBytesUntil()]]</code>: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). | * الدالة <code>[[Arduino/serial/readbytesuntil|readBytesUntil()]]</code>: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). | ||
| − | |||
* الدالة <code>[[Arduino/serial/settimeout|setTimeout()]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. | * الدالة <code>[[Arduino/serial/settimeout|setTimeout()]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. | ||
* الدالة <code>[[Arduino/serial/serialevent|serialEvent()]]</code>: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي. | * الدالة <code>[[Arduino/serial/serialevent|serialEvent()]]</code>: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي. | ||
| سطر 29: | سطر 29: | ||
==مصادر== | ==مصادر== | ||
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/readstringuntil/ صفحة الدالة Serial.readStringUntil() في توثيق أردوينو الرسمي.] | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/readstringuntil/ صفحة الدالة Serial.readStringUntil() في توثيق أردوينو الرسمي.] | ||
| + | [[تصنيف: Arduino]] | ||
| + | [[تصنيف: Arduino Function]] | ||
| + | [[تصنيف: Arduino Communication]] | ||
| + | [[تصنيف: Arduino Serial]] | ||
مراجعة 09:56، 22 أكتوبر 2018
تقرأ الدالة readStringUntil() جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. سيُنهَى عمل الدالة readStringUntil() إن عُثِر على محرف الإنهاء المُمرَّر إليها أو انتهت المهلة الزمنية (اطلع على الدالة setTimeout()).
إن عثرت الدالة readStringUntil() على محرف الإنهاء المُمرَّر إليها، فستعيد جميع المحارف التي قرأتها حتى المحرف الذي يسبق محرف الإنهاء (لا يدخل ضمن المحارف المقروءة).
ترث الدالة readStringUntil() من الصنف Stream.
البنية العامة
Serial.readStringUntil(terminator)
المعاملات
terminator
محرف يمثِّل محرف إنهاءٍ لعملية القراءة.
القيم المعادة
تعاد سلسلة نصية تحوي المحارف المقروءة حتى المحرف terminator (إن عُثِر عليه) من مخزَّن الاتصال التسلسلي الذي يخزِّن البيانات المستلمة.
انظر أيضًا
- الدالة
available(): تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. - الدالة
findUntil(): تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - الدالة
parseFloat(): تعيد أول عدد عشري صالح من مخزَّن الاتصال التسلسلي المؤقت. - الدالة
peek(): تعيد البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. - الدالة
readBytesUntil(): تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). - الدالة
setTimeout(): تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - الدالة
serialEvent(): تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.