الفرق بين المراجعتين لصفحة: «Arduino/serial/peek»

من موسوعة حسوب
إضافة محتويات الصفحة.
طلا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>Serial.peek()‎</code> في أردوينو}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>Serial.peek()‎</code> في أردوينو}}</noinclude>
تعيد الدالة <code>peek()‎</code> البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. هذا يعني أنَّ الاستدعاء المتعاقب للدالة <code>peek()‎</code> سيعيد نفس المحرف مثلما سيعيد الاستدعاء التالي للدالة <code>[[Arduino/serial/read|read()‎]]</code>.


ترث الدالة <code>peek()‎</code> من الصنف <code>[[Arduino/stream|stream]]</code>.
يعيد التابع <code>peek()‎</code> البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. هذا يعني أنَّ الاستدعاء المتعاقب للتابع <code>peek()‎</code> سيعيد نفس المحرف مثلما سيعيد الاستدعاء التالي للتابع <code>[[Arduino/serial/read|read()‎]]</code>.
 
يرث التابع <code>peek()‎</code> من الصنف <code>[[Arduino/stream|stream]]</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="arduino">
<syntaxhighlight lang="arduino">
سطر 15: سطر 16:
يعاد البايت الأول من البيانات المستلمة عبر الاتصال التسلسلي، أو القيمة 1- إن لم يكن هنالك أية بيانات متاحة.
يعاد البايت الأول من البيانات المستلمة عبر الاتصال التسلسلي، أو القيمة 1- إن لم يكن هنالك أية بيانات متاحة.
==انظر أيضًا==
==انظر أيضًا==
*الدالة <code>[[Arduino/serial/available|available()‎]]</code>: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/available|available()‎]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
*الدالة <code>[[Arduino/serial/find|find()‎]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
*التابع <code>[[Arduino/serial/find|find()‎]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
*الدالة <code>[[Arduino/serial/parsefloat|parseFloat()‎]]</code>: تعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
*التابع <code>[[Arduino/serial/parsefloat|parseFloat()‎]]</code>: يعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
*الدالة <code>[[Arduino/serial/parseint|parseInt()‎]]</code>: تعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
*التابع <code>[[Arduino/serial/parseint|parseInt()‎]]</code>: يعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
*الدالة <code>[[Arduino/serial/read|read()‎]]</code>: تقرأ البيانات المستلمة عبر الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/read|read()‎]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
*الدالة <code>[[Arduino/serial/readbytes|readBytes()‎]]</code>: تقرأ البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). 
*التابع <code>[[Arduino/serial/readbytes|readBytes()‎]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). 
*الدالة <code>[[Arduino/serial/readstring|readString()‎]]</code>: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
*التابع <code>[[Arduino/serial/readstring|readString()‎]]</code>: يقرأ المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
*الدالة <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/settimeout|setTimeout()‎]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.
*الدالة <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
*التابع <code>[[Arduino/serial/serialevent|serialEvent()‎]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.
==مصادر==
==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/peek/ صفحة الدالة Serial.peek()‎ في توثيق أردوينو الرسمي.]
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/peek/ صفحة التابع Serial.peek()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Function]]
[[تصنيف: Arduino Method]]
[[تصنيف: Arduino Communication]]
[[تصنيف: Arduino Communication]]
[[تصنيف: Arduino Serial]]
[[تصنيف: Arduino Serial]]

مراجعة 17:47، 6 نوفمبر 2018


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

يرث التابع peek()‎ من الصنف stream.

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

Serial.peek()

// فقط Mega لوحات أردوينو
Serial1.peek()
Serial2.peek()
Serial3.peek()

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

يعاد البايت الأول من البيانات المستلمة عبر الاتصال التسلسلي، أو القيمة 1- إن لم يكن هنالك أية بيانات متاحة.

انظر أيضًا

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

مصادر