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