Reference   Language (extended) | Libraries | Comparison | Board

parseInt()

Description

Looks for the next valid integer in the incoming serial stream. parseInt() inherits from the Stream utility class.

In particular:

• Initial characters that are not digits or a minus sign, are skipped;
• Parsing stops when no characters have been read for a configurable time-out value, or a non-digit is read;
• If no valid digits were read when the time-out (see Serial.setTimeout()) occurs, 0 is returned;

Syntax

Serial.parseInt()

Serial.parseInt(char skipChar)

Arduino Mega only:
Serial1.parseInt()
Serial2.parseInt()
Serial3.parseInt()

Parameters

skipChar: used to skip the indicated char in the search. Used for example to skip thousands divider.

Returns

long : the next valid integer

See also

• Serial
• Stream
• Stream.parseInt()

Reference Home

Corrections, suggestions, and new documentation should be posted to the Forum.

The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.