الفرق بين المراجعتين ل"Arduino/stream/streamfind"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE:التابع <code>Stream.find()</code> في أردوينو}}</noinclude> |
− | + | يتحقَّق التابع <code>find()</code> من وجود السلسلة النصية المُمرَّرة إليه ضمن البيانات المستلمة من المجرى. | |
− | + | هذا التابع هو جزءٌ من الصنف <code>[[Arduino/stream|Stream]]</code>، ويُستدعَى عبر أي صنف يرث من هذا الصنف (مثل <code>[[Arduino/wire|Wire]]</code>، و <code>[[Arduino/serial|Serial]]</code> ...إلخ.). اطلع على الصفحة الرئيسية للصنف <code>[[Arduino/stream|Stream]]</code> لمزيد من المعلومات. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
سطر 16: | سطر 16: | ||
تعاد القيمة <code>ture</code> إن كان المعامل <code>target</code> موجودًا في بيانات ذاكرة التخزين المؤقتة للمجرى <code>stream</code>، أو القيمة <code>false</code> إن لم يُعثَر عليها أو انتهت المهلة الزمنية. | تعاد القيمة <code>ture</code> إن كان المعامل <code>target</code> موجودًا في بيانات ذاكرة التخزين المؤقتة للمجرى <code>stream</code>، أو القيمة <code>false</code> إن لم يُعثَر عليها أو انتهت المهلة الزمنية. | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
− | * | + | *التابع <code>[[Arduino/stream/streamavailable|available()]]</code>: يجلب عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة. |
− | * | + | *التابع <code>[[Arduino/stream/streamread|read()]]</code>: يقرأ البيانات المستلمة من المجرى. |
− | * | + | *التابع <code>[[Arduino/stream/streamflush|flush()]]</code>: يمسح المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى. |
− | * | + | *التابع <code>[[Arduino/stream/streamfinduntil|findUntil()]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من البيانات المستلمة من المجرى. |
− | * | + | *التابع <code>[[Arduino/stream/streampeek|peek()]]</code>: يعيد بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت. |
− | * | + | *التابع <code>[[Arduino/stream/streamreadbytes|readBytes()]]</code>: يقرأ البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). |
− | * | + | *التابع <code>[[Arduino//stream/streamreadbytesuntil|readBytesUntil()]]</code>: يقرأ جزءًا محدَّدًا من البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). |
− | * | + | *التابع <code>[[Arduino/stream/streamreadstring|readString()]]</code>: يقرأ المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. |
− | * | + | *التابع <code>[[Arduino/stream/streamreadstringuntil|readStringUntil()]]</code>: يقرأ جزءًا من المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. |
− | * | + | *التابع <code>[[Arduino/stream/streamparseint|parseInt()]]</code>: يعيد أول [[Arduino/int|عدد صحيح]] (أو [[Arduino/long|طويل]]) صالح من الموضع الحالي للمجرى. |
− | * | + | *التابع <code>[[Arduino/stream/streamparsefloat|parseFloat()]]</code>: يعيد أول [[Arduino/float|عدد عشري]] صالح من من الموضع الحالي للمجرى. |
− | * | + | *التابع <code>[[Arduino/stream/streamsettimeout|setTimeout()]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى. |
− | |||
==مصادر== | ==مصادر== | ||
− | *[https://www.arduino.cc/reference/en/language/functions/communication/stream/streamfind/ صفحة | + | *[https://www.arduino.cc/reference/en/language/functions/communication/stream/streamfind/ صفحة التابع Stream.find() في توثيق أردوينو الرسمي.] |
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
− | [[تصنيف: Arduino | + | [[تصنيف: Arduino Method]] |
[[تصنيف: Arduino Communication]] | [[تصنيف: Arduino Communication]] | ||
[[تصنيف: Arduino Stream]] | [[تصنيف: Arduino Stream]] |
المراجعة الحالية بتاريخ 19:28، 6 نوفمبر 2018
يتحقَّق التابع find()
من وجود السلسلة النصية المُمرَّرة إليه ضمن البيانات المستلمة من المجرى.
هذا التابع هو جزءٌ من الصنف Stream
، ويُستدعَى عبر أي صنف يرث من هذا الصنف (مثل Wire
، و Serial
...إلخ.). اطلع على الصفحة الرئيسية للصنف Stream
لمزيد من المعلومات.
البنية العامة
stream.find(target)
يمثِّل stream
نسخةً من الصنف الذي يرث من الصنف Stream
.
المعاملات
target
السلسلة النصية المراد البحث عنها والتحقُّق من استلامها.
القيم المعادة
تعاد القيمة ture
إن كان المعامل target
موجودًا في بيانات ذاكرة التخزين المؤقتة للمجرى stream
، أو القيمة false
إن لم يُعثَر عليها أو انتهت المهلة الزمنية.
انظر أيضًا
- التابع
available()
: يجلب عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة. - التابع
read()
: يقرأ البيانات المستلمة من المجرى. - التابع
flush()
: يمسح المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى. - التابع
findUntil()
: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من البيانات المستلمة من المجرى. - التابع
peek()
: يعيد بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت. - التابع
readBytes()
: يقرأ البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). - التابع
readBytesUntil()
: يقرأ جزءًا محدَّدًا من البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer). - التابع
readString()
: يقرأ المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. - التابع
readStringUntil()
: يقرأ جزءًا من المحارف المستلمة من المجرى ويعيدها كسلسلة نصية. - التابع
parseInt()
: يعيد أول عدد صحيح (أو طويل) صالح من الموضع الحالي للمجرى. - التابع
parseFloat()
: يعيد أول عدد عشري صالح من من الموضع الحالي للمجرى. - التابع
setTimeout()
: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.