الفرق بين المراجعتين لصفحة: «Arduino/serial/read»
جميل-بيلوني (نقاش | مساهمات) أنشأ الصفحة ب'تقرأ الدالة <code>read()</code> البيانات المستلمة عبر الاتصال التسلسلي. ترث الدالة <code>read()</code> من...' |
جميل-بيلوني (نقاش | مساهمات) إضافة محتويات الصفحة. |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>Serial.read()</code> في أردوينو}}</noinclude> | |||
تقرأ الدالة <code>read()</code> البيانات المستلمة عبر الاتصال التسلسلي. | تقرأ الدالة <code>read()</code> البيانات المستلمة عبر الاتصال التسلسلي. | ||
ترث الدالة <code>read()</code> من الصنف <code>[[Arduino/stream|Stream]]</code>. | ترث الدالة <code>read()</code> من الصنف <code>[[Arduino/stream|Stream]]</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
سطر 12: | سطر 12: | ||
Serial3.read() | Serial3.read() | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | |||
== القيم المعادة == | |||
يعاد البايت الأول من البيانات المتاحة الآتية من منفذ الاتصال التسلسلي المحدَّد، أو تعاد القيمة 1- إن لم يكن هنالك أية بيانات متاحة للقراءة. | يعاد البايت الأول من البيانات المتاحة الآتية من منفذ الاتصال التسلسلي المحدَّد، أو تعاد القيمة 1- إن لم يكن هنالك أية بيانات متاحة للقراءة. | ||
==أمثلة== | |||
== أمثلة == | |||
قراءة البيانات المستلمة من منفذ الاتصال التسلسلي وإعادة إرسالها:<syntaxhighlight lang="arduino"> | قراءة البيانات المستلمة من منفذ الاتصال التسلسلي وإعادة إرسالها:<syntaxhighlight lang="arduino"> | ||
int incomingByte = 0; // متغير لتخزين البيانات المراد قراءتها | int incomingByte = 0; // متغير لتخزين البيانات المراد قراءتها | ||
سطر 37: | سطر 35: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | |||
== انظر أيضًا == | *الدالة <code>[[Arduino/serial/available|available()]]</code>: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. | ||
*الدالة <code>[[Arduino/serial/find|find()]]</code>: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. | |||
*الدالة <code>[[Arduino/serial/parseint|parseInt()]]</code>: تعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. | |||
*الدالة <code>[[Arduino/serial/readbytes|readBytes()]]</code>: تقرأ البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). | |||
*الدالة <code>[[Arduino/serial/readbytesuntil|readBytesUntil()]]</code>: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). | |||
*الدالة <code>[[Arduino/serial/readstring|readString()]]</code>: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. | |||
*الدالة <code>[[Arduino/serial/readstringuntil|readStringUntil()]]</code>: تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. | |||
*الدالة <code>[[Arduino/serial/settimeout|setTimeout()]]</code>: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. | |||
*الدالة <code>[[Arduino/serial/serialevent|serialEvent()]]</code>: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي. | |||
==مصادر== | ==مصادر== | ||
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/read/ صفحة الدالة Serial.read() في توثيق أردوينو الرسمي.] | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/read/ صفحة الدالة Serial.read() في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | |||
[[تصنيف: Arduino Function]] | |||
[[تصنيف: Arduino Communication]] | |||
[[تصنيف: Arduino Serial]] |
مراجعة 09:57، 22 أكتوبر 2018
تقرأ الدالة read()
البيانات المستلمة عبر الاتصال التسلسلي.
ترث الدالة read()
من الصنف Stream
.
البنية العامة
Serial.read()
// فقط Mega لوحات أردوينو
Serial1.read()
Serial2.read()
Serial3.read()
القيم المعادة
يعاد البايت الأول من البيانات المتاحة الآتية من منفذ الاتصال التسلسلي المحدَّد، أو تعاد القيمة 1- إن لم يكن هنالك أية بيانات متاحة للقراءة.
أمثلة
قراءة البيانات المستلمة من منفذ الاتصال التسلسلي وإعادة إرسالها:
int incomingByte = 0; // متغير لتخزين البيانات المراد قراءتها
void setup() {
Serial.begin(9600); // فتح منفذ اتصال تسلسلي بمعدل 9600 بت/ثا
}
void loop() {
// إرسال بيانات عند استلام أخرى فقط
if (Serial.available() > 0) {
// قراءة بايتٍ من البيانات المستلمة
incomingByte = Serial.read();
// إعادة إرسال نفس البايت المستلم
Serial.print("I received: ");
Serial.println(incomingByte, DEC);
}
}
انظر أيضًا
- الدالة
available()
: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. - الدالة
find()
: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. - الدالة
parseInt()
: تعيد أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت. - الدالة
readBytes()
: تقرأ البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). - الدالة
readBytesUntil()
: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). - الدالة
readString()
: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. - الدالة
readStringUntil()
: تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية. - الدالة
setTimeout()
: تضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - الدالة
serialEvent()
: تُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.