I want to find...

Search

Shares

Table of Content

server.available()

[Ethernet]

Description

Gets a client that is connected to the server and has data available for reading. The connection persists when the returned client object goes out of scope; you can close it by calling client.stop().

available() inherits from the Stream utility class.

Syntax

// telnet defaults to port
EthernetServer server = EthernetServer(int);

server.available()

Parameters

None

Returns

a Client object; if no Client has data available for reading, this object will evaluate to false in an if-statement (see the example below)

Example

#include <Ethernet.h>
 
//the IP address:
byte ip[] = { 10, 0, 0, 177 };    
// the router's gateway address:
byte gateway[] = { 10, 0, 0, 1 };
// the subnet:
byte subnet[] = { 255, 255, 0, 0 };
 
// telnet defaults to port 23
EthernetServer server = EthernetServer(23);
 
void setup()
{
  // initialize the ethernet device
  Ethernet.begin(NULL, ip, gateway, subnet);
 
  // start listening for clients
  server.begin();
}
 
void loop()
{
  // if an incoming client connects, there will be bytes available to read:
  EthernetClient client = server.available();
  if (client == true) {
    // read bytes from the incoming client and write them back
    // to any clients connected to the server:
    server.write(client.read());
  }
}

See Also

Libraries Reference Home

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

Leave a Comment

More Articles

Scroll to Top