التابع `Serial.write()‎` في أردوينو

يكتب التابع write()‎ بيانات ثنائية على منفذ الاتصال التسلسلي. تُرسَل هذه البيانات كبايت أو سلسلة من البايتات. إن أردت إرسال محارف تمثِّل أرقام عددٍ، فاستعمل التابع print()‎ عوضًا ذلك.

البنية العامة

Serial.write(val)
Serial.write(str)
Serial.write(buf, len)

// أيضًا Serial3, Serial2, Serial1 استعمال المنافذ Mega تدعم لوحات أردوينو

المعاملات

`val`

قيمةٌ يراد إرسالها على أنَّها بايتٌ مفردٌ.

`str`

سلسلةٌ نصيةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة.

`buf`

مصفوفةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة.

القيم المعادة

يعاد عدد البايتات التي كُتبَت على المنفذ التسلسلي.

أمثلة

استعمال التابع write()‎ لإرسال بايت واحد وسلسلة من البايتات إلى المنفذ التسلسلي:

void setup(){
  Serial.begin(9600);
}

void loop(){
  Serial.write(45); // إرسال بايت قيمته 45

   int bytesSent = Serial.write(“hello”); // وتخزين طولها بعد نجاح العملية “hello” إرسال السلسلة النصية
}

انظر أيضًا

التابع availableForWrite()‎: يجلب عدد البايتات (المحارف) المتاحة للكتابة في ذاكرة التخزين المؤقتة لمنفذ الاتصال التسلسلي دون حجب عملية الكتابة.
التابع begin()‎: يضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي.
التابع print()‎: يطبع البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته).
التابع println()‎: يطبع البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته) ثمَّ يُتبعها بمحرف العودة إلى بداية السطر (المحرف 'r\' أو ASCII 13) ومحرف سطر جديد (المحرف 'n\' أو ASCII 10).
التابع read()‎: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.

مصادر

صفحة التابع Serial.write()‎ في توثيق أردوينو الرسمي.