Arduino

Reference Language | Libraries | Comparison | Changes

Ethernet : Server class

## available()

#### 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().

#### Syntax

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 media access control (ethernet hardware) address for the shield:
    byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
    //the IP address for the shield:
    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
    Server server = Server(23);

    void setup()
    {
      // initialize the ethernet device
      Ethernet.begin(mac, ip, gateway, subnet);

      // start listening for clients
      server.begin();
    }

    void loop()
    {
      // if an incoming client connects, there will be bytes available to read:
      Client 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());
      }
    }

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.

Share|
©Arduino | Edit Page | Page History | Printable View | All Recent Site Changes