Serial.readString()

Описание

Serial.readString() считывает символы из буфера последовательного порта в строку String. Функция завершается, если истекает тайм-аут (см. setTimeout()).

Serial.readString() наследуется от служебного класса Stream.

Синтаксис

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

Serial.readString()

Параметры

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

Serial: объект последовательного порта. Список доступных последовательных портов для каждой платы см. на главной странице Serial.

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

Функция возвращает String, считанную из буфера последовательного порта.

Пример кода

Демонстрация Serial.readString():

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

void loop() {
  Serial.println("Enter data:");
  while (Serial.available() == 0) {}     //ждём поступления данных
  String teststr = Serial.readString();  //читаем до тайм-аута
  teststr.trim();                        // удаляем любые \r \n пробельные символы в конце строки
  if (teststr == "red") {
    Serial.println("A primary color");
  } else {
    Serial.println("Something else");
  }
}

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

Примечание

Функция не завершается раньше, если данные содержат символы конца строки. Возвращаемая строка String может содержать символы возврата каретки и/или перевода строки, если они были получены.