名称

Serial.readBytes()

説明

Serial.readBytes()は、シリアルポートから文字列をバッファに読み込む。この関数は指定した長さの文字列が読み込まれるかタイムアウトすれば終了する(Serial.setTimeout()参照)。

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

書式

シリアルポートから文字列を読み、バッファに格納するには、以下の関数を使う。

Serial.readBytes(buffer, length)

C言語シグネチャ(avr)

size_t HardwareSerial::readBytes(char *buffer, size_t length);

引数

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

`Serial`	シリアルポートオブジェクト。各ボードで利用可能なシリアルポートオブジェクトは、Serialを参照。
`buffer`	文字列を格納するバッファ。データ型: `char`あるいは`byte`配列。
`length`	読み込む文字列の長さ。データ型: `int`。

戻り値

バッファに読み込んだ文字列の長さ。データを読み込めなかった場合は、0。データ型: size_t。

コード例

次のコードは、5文字分のバッファを作成し、シリアル通信から受信した文字を格納する。

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


char data[6];  // 5 bytes + null terminator

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

  Serial.println("Send 5 characters:");
}

void loop() {
  if (Serial.available() >= 5) {
    int bytesRead = Serial.readBytes(data, 5);
    data[bytesRead] = '\0';  // Null-terminate the string

    Serial.print("Received: ");
    Serial.println(data);
  }
}

参照

オリジナルのページ

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

実装の解析

まだ解析していません。

最終更新日

July 18, 2026