名称

Serial.parseInt()

説明

シリアル入力から、次の有効な整数を検索する。この関数はタイムアウトが発生すると終了する(Serial.setTimeout()を参照)。

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

特に、

タイムアウト時間内に文字や非数値を読み込まなかった場合は、パースが停止する。
タイムアウトが発生したときに(Serial.setTimeout()参照)、有効な数字が読まれていない場合は、0を返す。

書式

シリアルバッファ内の整数を検索するには、以下の関数のいずれかを使う。

Serial.parseInt()
Serial.parseInt(lookahead)
Serial.parseInt(lookahead, ignore)

C言語シグネチャ(avr)

long HardwareSerial::parseInt(LookaheadMode lookahead = SKIP_ALL, char ignore = NO_IGNORE_CHAR);

long HardwareSerial::parseInt(char ignore) ;

引数

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

`Serial`	シリアルポートオブジェクト。各ボードで利用可能なシリアルポートオブジェクトは、Serialを参照。
`lookahead`	整数が現れるまでにスキップするモード。データ型: LookaheadMode。
	`lookahead`の値。
	`SKIP_ALL`: マイナス符号、数字以外は、すべてスキップ。デフォルトのモード。
	`SKIP_NONE`: スキップしない。最初の文字が有効な文字でない限り、ストリームは操作されない。
	`SKIP_WHITESPACE`: タブとスペース、ラインフィード、キャリッジリターンをスキップ。
`ignore`	有効な文字が現れてから無視する文字。例えば、1000毎の区切り文字をスキップするために使われる。データ型: `char`。

戻り値

最初に見つかった整数。データ型: long。

コード例

以下のコートは、シリアルで受信した最初の有効な整数を返す。

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


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

  Serial.println("Enter a integer number:");  // try with a mixed phrase e.g. "The size of the box is 5 mm"
}

void loop() {
  if (Serial.available()) {
    int number = Serial.parseInt();
    if (number != 0) {
      Serial.print("You entered: ");
      Serial.println(number);
    }
  }
}

参照

オリジナルのページ

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

実装の解析

まだ解析していません。

最終更新日

August 16, 2026