Arduino/serial/println

يطبع التابع 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()‎: يكتب بيانات ثنائية على منفذ الاتصال التسلسلي.

مصادر

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