الفرق بين المراجعتين ل"Arduino/serial/println"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE:التابع <code>Serial.println()</code> في أردوينو}}</noinclude> |
| − | + | يطبع التابع <code>println()</code> البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته) ثمَّ يُتبعها بمحرف العودة إلى بداية السطر (المحرف 'r\' أو ASCII 13) ومحرف سطر جديد (المحرف 'n\' أو ASCII 10). بعبارة أخرى، يشبه هذا التابع التابع <code>[[Arduino/serial/print|print()]]</code> تمامًا باستثناء أنه يضيف محرف العودة إلى بداية السطر ومحرف سطر جديد إلى نهاية البيانات التي يطبعها، لذا ارجع إلى التابع <code>[[Arduino/serial/print|print()]]</code> لتفاصيل وشرح أوسع. | |
| − | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
| سطر 7: | سطر 6: | ||
Serial.println(val, format) | Serial.println(val, format) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ==المعاملات== | |
| − | == المعاملات == | + | ===<code>val</code>=== |
| − | |||
| − | === <code>val</code> === | ||
البيانات المراد طباعتها على منفذ الاتصال التسلسلي. | البيانات المراد طباعتها على منفذ الاتصال التسلسلي. | ||
| − | + | ===<code>format</code>=== | |
| − | === <code>format</code> === | ||
معامل اختياري يحدِّد تنسيق (أساس) البيانات المراد طباعتها. القيم المتاحة التي يمكن استعمالها هي: | معامل اختياري يحدِّد تنسيق (أساس) البيانات المراد طباعتها. القيم المتاحة التي يمكن استعمالها هي: | ||
| − | * <code>BIN(binary, or base 2)</code> | + | *<code>BIN(binary, or base 2)</code> |
| − | * <code>OCT(octal, or base 8)</code> | + | *<code>OCT(octal, or base 8)</code> |
| − | * <code>DEC(decimal, or base 10)</code> | + | *<code>DEC(decimal, or base 10)</code> |
| − | * <code>HEX(hexadecimal, or base 16)</code> | + | *<code>HEX(hexadecimal, or base 16)</code> |
إن كان المعامل <code>val</code> عددًأ عشريًّا، فسيُحدِّد هذا المعامل دقة ذلك العدد (عدد الأرقام بعد الفاصلة). | إن كان المعامل <code>val</code> عددًأ عشريًّا، فسيُحدِّد هذا المعامل دقة ذلك العدد (عدد الأرقام بعد الفاصلة). | ||
| − | |||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد عدد البايتات التي كُتبَت. | يعاد عدد البايتات التي كُتبَت. | ||
| − | + | ==أمثلة== | |
| − | == أمثلة == | ||
قراءة دخل تشابهي من الرجل 0 وإرسال القيمة عبر منفذ الاتصال التسلسلي:<syntaxhighlight lang="arduino"> | قراءة دخل تشابهي من الرجل 0 وإرسال القيمة عبر منفذ الاتصال التسلسلي:<syntaxhighlight lang="arduino"> | ||
/* | /* | ||
created 24 March 2006 | created 24 March 2006 | ||
by Tom Igoe | by Tom Igoe | ||
| + | Edited by wiki Hsoub | ||
| + | on 6 November 2018 | ||
*/ | */ | ||
| سطر 52: | سطر 48: | ||
delay(10); | delay(10); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ==انظر أيضًا== | |
| − | == انظر أيضًا == | + | *التابع <code>[[Arduino/serial/availableforwrite|availableForWrite()]]</code>: يجلب عدد البايتات (المحارف) المتاحة للكتابة في ذاكرة التخزين المؤقتة لمنفذ الاتصال التسلسلي دون حجب عملية الكتابة. |
| − | * | + | *التابع <code>[[Arduino/serial/end|end()]]</code>: يعطِّل الاتصال التسلسلي المفتوح محرِّرةً بذلك الرجل 0 (RX) والرجل 1 (TX) لتصبح قابلةً للاستعمال كدخل أو خرج رقمي. |
| − | * | + | *التابع <code>[[Arduino/serial/flush|flush()]]</code>: ينتظر اكتمال عملية نقل البيانات المرسلة عبر الاتصال التسلسلي |
| − | * | + | *التابع <code>[[Arduino/serial/print|print()]]</code>: يطبع البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته). |
| − | * | + | *التابع <code>[[Arduino/serial/read|read()]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي. |
| − | * | + | *التابع <code>[[Arduino/serial/write|write()]]</code>: يكتب بيانات ثنائية على منفذ الاتصال التسلسلي. |
| − | * | ||
| − | |||
==مصادر== | ==مصادر== | ||
| − | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/println/ صفحة | + | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/println/ صفحة التابع Serial.println() في توثيق أردوينو الرسمي.] |
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
| − | [[تصنيف: Arduino | + | [[تصنيف: Arduino Method]] |
[[تصنيف: Arduino Communication]] | [[تصنيف: Arduino Communication]] | ||
[[تصنيف: Arduino Serial]] | [[تصنيف: Arduino Serial]] | ||
المراجعة الحالية بتاريخ 18:16، 6 نوفمبر 2018
يطبع التابع println() البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته) ثمَّ يُتبعها بمحرف العودة إلى بداية السطر (المحرف 'r\' أو ASCII 13) ومحرف سطر جديد (المحرف 'n\' أو ASCII 10). بعبارة أخرى، يشبه هذا التابع التابع print() تمامًا باستثناء أنه يضيف محرف العودة إلى بداية السطر ومحرف سطر جديد إلى نهاية البيانات التي يطبعها، لذا ارجع إلى التابع print() لتفاصيل وشرح أوسع.
البنية العامة
Serial.println(val)
Serial.println(val, format)
المعاملات
val
البيانات المراد طباعتها على منفذ الاتصال التسلسلي.
format
معامل اختياري يحدِّد تنسيق (أساس) البيانات المراد طباعتها. القيم المتاحة التي يمكن استعمالها هي:
BIN(binary, or base 2)OCT(octal, or base 8)DEC(decimal, or base 10)HEX(hexadecimal, or base 16)
إن كان المعامل val عددًأ عشريًّا، فسيُحدِّد هذا المعامل دقة ذلك العدد (عدد الأرقام بعد الفاصلة).
القيم المعادة
يعاد عدد البايتات التي كُتبَت.
أمثلة
قراءة دخل تشابهي من الرجل 0 وإرسال القيمة عبر منفذ الاتصال التسلسلي:
/*
created 24 March 2006
by Tom Igoe
Edited by wiki Hsoub
on 6 November 2018
*/
int analogValue = 0; // متغير لتخزين القيمة المراد قراءتها
void setup() {
// فتح منفذ اتصال تسلسلي بمعدل 9600 بت/ثا
Serial.begin(9600);
}
void loop() {
// قراءة الدخل التشابهي من الرجل 0
analogValue = analogRead(0);
// طباعة القيمة المقروءة بتنسيقات مختلفة
Serial.println(analogValue); // print as an ASCII-encoded decimal
Serial.println(analogValue, DEC); // print as an ASCII-encoded decimal
Serial.println(analogValue, HEX); // print as an ASCII-encoded hexadecimal
Serial.println(analogValue, OCT); // print as an ASCII-encoded octal
Serial.println(analogValue, BIN); // print as an ASCII-encoded binary
// الانتظار لمدة 10 ميلي ثانية قبل إعادة تكرار العملية
delay(10);
انظر أيضًا
- التابع
availableForWrite(): يجلب عدد البايتات (المحارف) المتاحة للكتابة في ذاكرة التخزين المؤقتة لمنفذ الاتصال التسلسلي دون حجب عملية الكتابة. - التابع
end(): يعطِّل الاتصال التسلسلي المفتوح محرِّرةً بذلك الرجل 0 (RX) والرجل 1 (TX) لتصبح قابلةً للاستعمال كدخل أو خرج رقمي. - التابع
flush(): ينتظر اكتمال عملية نقل البيانات المرسلة عبر الاتصال التسلسلي - التابع
print(): يطبع البيانات المُمرَّرة إليه على منفذ الاتصال التسلسلي بترميز ASCII (أي نص يستطيع الأشخاص الآخرين قراءته). - التابع
read(): يقرأ البيانات المستلمة عبر الاتصال التسلسلي. - التابع
write(): يكتب بيانات ثنائية على منفذ الاتصال التسلسلي.