الفرق بين المراجعتين ل"Arduino/stream/streampeek"

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

المراجعة الحالية بتاريخ 19:28، 6 نوفمبر 2018

يعيد التابع peek()‎ بايتًا من البيانات المستلمة من المجرى دون حذفه من المخزَّن الداخلي المؤقت. هذا يعني أنَّ الاستدعاء المتعاقب للتابع peek()‎ سيعيد نفس المحرف مثلما سيعيد الاستدعاء التالي للتابع read()‎ الذي سيعقبه.

هذا التابع هو جزءٌ من الصنف Stream، ويُستدعَى عبر أي صنف يرث من هذا الصنف (مثل Wire، و Serial ...إلخ.). اطلع على الصفحة الرئيسية للصنف Stream لمزيد من المعلومات.

البنية العامة

stream.peek()

يمثِّل stream نسخةً من الصنف الذي يرث من الصنف Stream.

القيم المعادة

يعاد البايت (المحرف) التالي من البيانات المستلمة عبر المجرى stream، أو القيمة 1- إن لم يكن هنالك أية بيانات متاحة.

انظر أيضًا

  • التابع available()‎: يجلب عدد البايتات المتاحة للقراءة من المجرى. يمثِّل هذا العدد حجم البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة.
  • التابع read()‎: يقرأ البيانات المستلمة من المجرى.
  • التابع flush()‎: يمسح المخزَّن المؤقت متى ما أرسلت جميع البيانات عبر المجرى.
  • التابع find()‎: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن البيانات المستلمة من المجرى.
  • التابع findUntil()‎: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من البيانات المستلمة من المجرى.
  • التابع readBytes(): يقرأ البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer).
  • التابع readBytesUntil(): يقرأ جزءًا محدَّدًا من البيانات المستلمة من المجرى ويضعها في متغير يمثِّل مخزنًا مؤقتًا (buffer).
  • التابع readString()‎: يقرأ المحارف المستلمة من المجرى ويعيدها كسلسلة نصية.
  • التابع readStringUntil(): يقرأ جزءًا من المحارف المستلمة من المجرى ويعيدها كسلسلة نصية.
  • التابع parseInt(): يعيد أول عدد صحيح (أو طويل) صالح من الموضع الحالي للمجرى.
  • التابع parseFloat()‎: يعيد أول عدد عشري صالح من من الموضع الحالي للمجرى.
  • التابع setTimeout()‎: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من المجرى.

مصادر