الفرق بين المراجعتين ل"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>[[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/ صفحة | + | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/read/ صفحة التابع Serial.read() في توثيق أردوينو الرسمي.] |
+ | [[تصنيف: Arduino]] | ||
+ | [[تصنيف: Arduino Method]] | ||
+ | [[تصنيف: Arduino Communication]] | ||
+ | [[تصنيف: Arduino Serial]] |
المراجعة الحالية بتاريخ 18:16، 6 نوفمبر 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()
: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.