الفرق بين المراجعتين ل"Arduino/serial/peek"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'تعيد الدالة <code>peek()‎</code> البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دو...')
 
ط
 
(مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين)
سطر 1: سطر 1:
تعيد الدالة <code>peek()‎</code> البايت (المحرف) التالي من البيانات المستلمة عبر الاتصال التسلسلي دون حذفه من المخزَّن الداخلي المؤقت للاتصال التسلسلي. هذا يعني أنَّ الاستدعاء المتعاقب للدالة <code>peek()‎</code> سيعيد نفس المحرف مثلما سيعيد الاستدعاء التالي للدالة <code>read()‎</code>.
+
<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>[[Arduino/stream|stream]]</code>.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="arduino">
 
<syntaxhighlight lang="arduino">
سطر 14: سطر 15:
 
يعاد البايت الأول من البيانات المستلمة عبر الاتصال التسلسلي، أو القيمة 1- إن لم يكن هنالك أية بيانات متاحة.
 
يعاد البايت الأول من البيانات المستلمة عبر الاتصال التسلسلي، أو القيمة 1- إن لم يكن هنالك أية بيانات متاحة.
 
==انظر أيضًا==
 
==انظر أيضًا==
 +
*التابع <code>[[Arduino/serial/available|available()‎]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
 +
*التابع <code>[[Arduino/serial/find|find()‎]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
 +
*التابع <code>[[Arduino/serial/parsefloat|parseFloat()‎]]</code>: يعيد أول [[Arduino/float|عدد عشري]] صالح من مخزَّن الاتصال التسلسلي المؤقت.
 +
*التابع <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/peek/ صفحة الدالة Serial.peek()‎ في توثيق أردوينو الرسمي.]
+
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/peek/ صفحة التابع Serial.peek()‎ في توثيق أردوينو الرسمي.]
 +
[[تصنيف: Arduino]]
 +
[[تصنيف: Arduino Method]]
 +
[[تصنيف: Arduino Communication]]
 +
[[تصنيف: Arduino Serial]]

المراجعة الحالية بتاريخ 17:49، 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()‎: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر