الدالة Serial.peek()‎ في أردوينو

من موسوعة حسوب
< Arduino‏ | serial
مراجعة 09:58، 22 أكتوبر 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()‎: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.

مصادر