Home Page | Language Reference (extended) | SD Reference | Libraries | Comparison | Changes

parseInt()

Description

parseInt() returns the first valid (long) integer number from the serial buffer. Characters that are not integers (or the minus sign) are skipped.

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 Stream.setTimeout()) occurs, 0 is returned;

This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the stream/Stream class main page for more information.

Syntax

stream.parseInt(list)

stream.parseInt(''list', char skipchar')

Parameters

stream : an instance of a class that inherits from Stream.
list : the stream to check for ints (char)skipChar: used to skip the indicated char in the search. Used for example to skip thousands divider.

Returns

long

See also

• stream/Stream

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.