EthernetUDP.write()

Description

Writes UDP data to the remote connection. Must be wrapped between beginPacket() and endPacket(). beginPacket() initializes the packet of data, it is not sent until endPacket() is called. (Remarks: the maximum size of the packet is 512-byte in 86Duino, in contrast with 24-byte in Arduino.)

Syntax


Udp.write(message);
Udp.write(buffer, size);

Parameters

message: the outgoing message (char)
buffer: an array to send as a series of bytes (byte or char)
size: the length of the buffer

Returns

byte : returns the number of characters sent. This does not have to be read

Example

#include <Ethernet.h>

#include <EthernetUdp.h>


// Enter an IP address for your controller below.
// The IP address will be dependent on your local network:

IPAddress ip(192, 168, 1, 177);


unsigned int localPort = 8888;      // local port to listen on


// An EthernetUDP instance to let us send and receive packets over UDP

EthernetUDP Udp;


void setup() {

  // start the Ethernet and UDP:

  Ethernet.begin(NULL,ip);

  Udp.begin(localPort);

}


void loop() {

  Udp.beginPacket(Udp.remoteIP(), Udp.remotePort());

  Udp.write("hello");

  Udp.endPacket();

}

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.