Serial.println()

Описание

Печатает данные в последовательный порт в виде ASCII-текста, читаемого человеком, после которого следуют символ возврата каретки (ASCII 13, или '\r') и символ новой строки (ASCII 10, или '\n'). Эта команда принимает те же формы, что и Serial.print().

Синтаксис

Используйте следующую функцию для печати любых данных через последовательную связь:

Serial.println(val)

Serial.println(val, format)

Параметры

Функция принимает следующие объекты и параметры:

Serial: объект последовательного порта. Список доступных последовательных портов для каждой платы см. на главной странице Serial.
val: значение для печати. Допустимые типы данных: любой тип данных.
format: задаёт основание системы счисления (для целочисленных типов данных) или количество знаков после запятой (для типов с плавающей точкой).

Возвращаемое значение

Функция возвращает количество записанных байтов, хотя считывание этого числа необязательно. Тип данных: size_t.

Пример кода

/*
  Аналоговый вход считывает аналоговое значение на аналоговом входе 0 и печатает его.
  created 24 March 2006
  by Tom Igoe
  */

int analogValue = 0;    // переменная для хранения аналогового значения

void setup() {
  // открываем последовательный порт на 9600 бод:
  Serial.begin(9600);
}

void loop() {
  // считываем аналоговый вход на пине 0:
  analogValue = analogRead(0);

  // печатаем его в нескольких форматах:
  Serial.println(analogValue);       // печать в виде десятичного числа в ASCII
  Serial.println(analogValue, DEC);  // печать в виде десятичного числа в ASCII
  Serial.println(analogValue, HEX);  // печать в виде шестнадцатеричного числа в ASCII
  Serial.println(analogValue, OCT);  // печать в виде восьмеричного числа в ASCII
  Serial.println(analogValue, BIN);  // печать в виде двоичного числа в ASCII

  // задержка 10 миллисекунд перед следующим чтением:
  delay(10);
}

Примечания и предупреждения

Примечание

Информацию об асинхронности Serial.println() см. в разделе «Notes and Warnings» на справочной странице Serial.write().