名称

Serial.readStringUntil()

説明

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

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

書式

シリアル入力から、終端文字が見つかるまでデータを読むには、以下の関数を使う。

Serial.readStringUntil(terminator)

C言語シグネチャ(avr)

String HardwareSerial::readStringUntil(char terminator);

引数

この関数は以下のオブジェクトと引数を受け付ける。

戻り値

シリアルバッファから、読み込んだ、終端文字までのString。終端文字が見つからない場合、終端文字の前にデータがない場合は、NULLが変える。

コード例

以下のコードは、改行コードを受信するまで、シリアル入力データを読む。

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

void setup() {
  Serial.begin(9600);
  while (!Serial);

  Serial.println("Enter a word and press Enter:");
}

void loop() {
  if (Serial.available()) {
    String input = Serial.readStringUntil('\n');  // Read until newline
    Serial.print("You entered: ");
    Serial.println(input);
  }
}

注意

終端文字はシリアルバッファから捨てられる。終端文字が見つからない場合は、読み込んだすべての文字が捨てられる。

参照

• Serial
• begin()
• end()
• available()
• read()
• peek()
• flush()
• print()
• println()
• write()
• serialEvent()
• stream.parseFloat()

オリジナルのページ

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

実装の解析

まだ解析していません。

最終更新日

July 18, 2026