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

SoftwareSerial: available()

Description

Get the number of bytes (characters) available for reading from a software serial port. This is data that's already arrived and stored in the serial receive buffer.

Syntax

mySerial.available()

Parameters

none

Returns

the number of bytes available to read

Example

// include the SoftwareSerial library so you can use its functions:
#include <SoftwareSerial.h> #define rxPin 10
#define txPin 11 // set up a new serial port
SoftwareSerial mySerial =  SoftwareSerial(rxPin, txPin) ; void setup ( )  {
  // define pin modes for tx, rx:
  pinMode (rxPin, INPUT ) ;
  pinMode (txPin, OUTPUT ) ;
  // set the data rate for the SoftwareSerial port
  mySerial.begin ( 9600 ) ;
} void loop ( ) {
  if (mySerial.available ( ) > 0 ) {
  mySerial.read ( ) ;
 }
}

See also


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.