الفرق بين المراجعتين لصفحة: «Arduino/serial/finduntil»
جميل-بيلوني (نقاش | مساهمات) أنشأ الصفحة ب'تتحقَّق الدالة <code>findUntil()</code> من وجود السلسلة النصية المُمرَّرة إليها ضمن جزء محدَّد من بيا...' |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
(2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Serial.findUntil()</code> في أردوينو}}</noinclude> | |||
يتحقَّق التابع <code>findUntil()</code> من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. | |||
يرث التابع <code>findUntil()</code> من الصنف <code>[[Arduino/stream|Stream]]</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
Serial.findUntil(target, terminal) | Serial.findUntil(target, terminal) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | |||
== المعاملات == | ===<code>target</code>=== | ||
=== <code>target</code> === | |||
السلسلة النصية المراد البحث عنها والتحقُّق من استلامها عبر الاتصال التسلسلي. | السلسلة النصية المراد البحث عنها والتحقُّق من استلامها عبر الاتصال التسلسلي. | ||
===<code>terminal</code>=== | |||
=== <code>terminal</code> === | |||
السلسلة النصية التي تمثِّل حد نهاية عملية البحث ضمن ذاكرة التخزين المؤقتة للاتصال التسلسلي. | السلسلة النصية التي تمثِّل حد نهاية عملية البحث ضمن ذاكرة التخزين المؤقتة للاتصال التسلسلي. | ||
==القيم المعادة== | |||
== القيم المعادة == | تعاد القيمة <code>ture</code> إن كان المعامل <code>target</code> موجودًا في الجزء المحدَّد ببداية ذاكرة التخزين المؤقتة للاتصال التسلسلي والمعامل <code>terminal</code>، أو القيمة <code>false</code> إن لم يُعثَر عليه ضمن ذلك الجزء أو انتهت المهلة الزمنية. | ||
تعاد القيمة <code>ture</code> إن كان المعامل <code>target</code> موجودًا في الجزء المحدَّد ببداية ذاكرة التخزين المؤقتة للاتصال التسلسلي والمعامل <code>terminal</code>، أو القيمة <code>false</code> إن لم يُعثَر | |||
==انظر أيضًا== | ==انظر أيضًا== | ||
*التابع <code>[[Arduino/serial/available|available()]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. | |||
*التابع <code>[[Arduino/serial/find|find()]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. | |||
*التابع <code>[[Arduino/serial/parsefloat|parseFloat()]]</code>: يعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت. | |||
*التابع <code>[[Arduino/serial/parseint|parseInt()]]</code>: يعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. | |||
*التابع <code>[[Arduino/serial/read|read()]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي. | |||
*التابع <code>[[Arduino/serial/readbytesuntil|readBytesUntil()]]</code>: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). | |||
*التابع <code>[[Arduino/serial/readstringuntil|readStringUntil()]]</code>: يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية. | |||
*التابع <code>[[Arduino/serial/settimeout|setTimeout()]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. | |||
*التابع <code>[[Arduino/serial/serialevent|serialEvent()]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي. | |||
==مصادر== | ==مصادر== | ||
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/finduntil/ صفحة | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/finduntil/ صفحة التابع Serial.findUntil() في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | |||
[[تصنيف: Arduino Method]] | |||
[[تصنيف: Arduino Communication]] | |||
[[تصنيف: Arduino Serial]] |
المراجعة الحالية بتاريخ 17:48، 6 نوفمبر 2018
يتحقَّق التابع findUntil()
من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
يرث التابع findUntil()
من الصنف Stream
.
البنية العامة
Serial.findUntil(target, terminal)
المعاملات
target
السلسلة النصية المراد البحث عنها والتحقُّق من استلامها عبر الاتصال التسلسلي.
terminal
السلسلة النصية التي تمثِّل حد نهاية عملية البحث ضمن ذاكرة التخزين المؤقتة للاتصال التسلسلي.
القيم المعادة
تعاد القيمة ture
إن كان المعامل target
موجودًا في الجزء المحدَّد ببداية ذاكرة التخزين المؤقتة للاتصال التسلسلي والمعامل terminal
، أو القيمة false
إن لم يُعثَر عليه ضمن ذلك الجزء أو انتهت المهلة الزمنية.
انظر أيضًا
- التابع
available()
: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. - التابع
find()
: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - التابع
parseFloat()
: يعيد أول عدد عشري صالح من مخزَّن الاتصال التسلسلي المؤقت. - التابع
parseInt()
: يعيد أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت. - التابع
read()
: يقرأ البيانات المستلمة عبر الاتصال التسلسلي. - التابع
readBytesUntil()
: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). - التابع
readStringUntil()
: يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية. - التابع
setTimeout()
: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - التابع
serialEvent()
: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.