Serial.readString()

名称

Serial.readString()

説明

Serial.readString()は、シリアルバッファから文字を読み、文字列に書き込む。この関数はタイムアウトすれば終了する(Serial.setTimeout()参照)。

Serial.readString()は、Streamユーティリティクラスを継承している。

書式

メソッド定義	`String HardwareSerial::readString();`
利用方法	`Serial.readString();`

引数

Serial

シリアルポートオブジェクト。

各ボードで利用可能なシリアルポートオブジェクトは、Serialを参照。

戻り値

シリアルバッファから読み込んだ文字列(Stringオブジェクト)。

使用例

Serial.readString()の使用例。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


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

void loop() {
  Serial.println("Enter data:");
  while (Serial.available() == 0) {}     //wait for data available
  String teststr = Serial.readString();  //read until timeout
  teststr.trim();                        // remove any \r \n whitespace at the end of the String
  if (teststr == "red") {
    Serial.println("A primary color");
  } else {
    Serial.println("Something else");
  }
}