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