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