Serial.readString()

Last revision:2025/06/06

名称

Serial.readString()

説明

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

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

書式

シリアル入力からデータを読むには、以下の関数を使う。

Serial.readString()

C言語シグネチャ(avr)

String HardwareSerial::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");
  }
}

注意

データが行末終端文字を含んでいても、この関数はすぐには終了しない。返却されるStringは、キャリッジリターンやラインフィードを受信した場合は、それらの文字が含まれる場合もある。

参照

オリジナルのページ

https://docs.arduino.cc/language-reference/en/functions/communication/serial/readString/

実装の解析

まだ解析していません。

最終更新日

August 16, 2026

inserted by FC2 system