الفرق بين المراجعتين لصفحة: «Arduino/serial/write»
جميل-بيلوني (نقاش | مساهمات) أنشأ الصفحة ب'تكتب الدالة <code>write()</code> بيانات ثنائية على منفذ الاتصال التسلسلي. تُرسَل هذه البيانات كبايت...' |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Serial.write()</code> في أردوينو}}</noinclude> | |||
يكتب التابع <code>write()</code> بيانات ثنائية على منفذ الاتصال التسلسلي. تُرسَل هذه البيانات كبايت أو سلسلة من البايتات. إن أردت إرسال محارف تمثِّل أرقام عددٍ، فاستعمل التابع <code>[[Arduino/serial/print|print()]]</code> عوضًا ذلك. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
| سطر 9: | سطر 9: | ||
// أيضًا Serial3, Serial2, Serial1 استعمال المنافذ Mega تدعم لوحات أردوينو | // أيضًا Serial3, Serial2, Serial1 استعمال المنافذ Mega تدعم لوحات أردوينو | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | |||
== المعاملات == | ===<code>val</code>=== | ||
=== <code>val</code> === | |||
قيمةٌ يراد إرسالها على أنَّها بايتٌ مفردٌ. | قيمةٌ يراد إرسالها على أنَّها بايتٌ مفردٌ. | ||
===<code>str</code>=== | |||
=== <code>str</code> === | |||
سلسلةٌ نصيةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة. | سلسلةٌ نصيةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة. | ||
===<code>buf</code>=== | |||
=== <code>buf</code> === | |||
مصفوفةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة. | مصفوفةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد عدد البايتات التي كُتبَت على المنفذ التسلسلي. | يعاد عدد البايتات التي كُتبَت على المنفذ التسلسلي. | ||
==أمثلة== | |||
== أمثلة == | استعمال التابع <code>write()</code> لإرسال بايت واحد وسلسلة من البايتات إلى المنفذ التسلسلي:<syntaxhighlight lang="arduino"> | ||
استعمال | |||
void setup(){ | void setup(){ | ||
Serial.begin(9600); | Serial.begin(9600); | ||
| سطر 37: | سطر 31: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* | *التابع <code>[[Arduino/serial/availableforwrite|availableForWrite()]]</code>: يجلب عدد البايتات (المحارف) المتاحة للكتابة في ذاكرة التخزين المؤقتة لمنفذ الاتصال التسلسلي دون حجب عملية الكتابة. | ||
* | *التابع <code>[[Arduino/serial/begin|begin()]]</code>: يضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي. | ||
* | *التابع <code>[[Arduino/serial/print|print()]]</code>: يطبع البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته). | ||
* | *التابع <code>[[Arduino/serial/println|println()]]</code>: يطبع البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته) ثمَّ يُتبعها بمحرف العودة إلى بداية السطر (المحرف 'r\' أو ASCII 13) ومحرف سطر جديد (المحرف 'n\' أو ASCII 10). | ||
* | *التابع <code>[[Arduino/serial/read|read()]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي. | ||
==مصادر== | ==مصادر== | ||
*[https://www.arduino.cc/reference/en/language/functions/communication/serial/parsefloat/https://www.arduino.cc/reference/en/language/functions/communication/serial/write/ صفحة | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/parsefloat/https://www.arduino.cc/reference/en/language/functions/communication/serial/write/ صفحة التابع Serial.write() في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | |||
[[تصنيف: Arduino Method]] | |||
[[تصنيف: Arduino Communication]] | |||
[[تصنيف: Arduino Serial]] | |||
المراجعة الحالية بتاريخ 18:18، 6 نوفمبر 2018
يكتب التابع 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(): يقرأ البيانات المستلمة عبر الاتصال التسلسلي.