Processing

Reference+
Documentation→Libraries→Core→Network

Class Name

Client

Description

A client connects to a server and sends data back and forth. If anything goes wrong with the connection, for example the host is not there or is listening on a different port, an exception is thrown.

Examples

  • import processing.net.*; 

Client myClient; 
int dataIn; 
 
void setup() { 
  size(200, 200); 
  // Connect to the local machine at port 5204.
  // This example will not run if you haven't
  // previously started a server on this port.
  myClient = new Client(this, "127.0.0.1", 5204); 
} 
 
void draw() { 
  if (myClient.available() > 0) { 
    dataIn = myClient.read(); 
  } 
  background(dataIn); 
}

Constructors

  • Client(parent, host, port)
  • Client(parent, socket)

Parameters

  • parent(PApplet)typically use "this"
  • host(String)address of the server
  • port(int)port to read/write from on the server
  • socket(Socket)any object of type Socket

Methods

  • stop()Disconnects from the server
  • active()Returns true if this client is still active
  • ip()Returns the IP address of the machine as a String
  • available()Returns the number of bytes in the buffer waiting to be read
  • clear()Clears the buffer
  • read()Returns a value from the buffer
  • readChar()Returns the next byte in the buffer as a char
  • readBytes()Reads a group of bytes from the buffer
  • readBytesUntil()Reads from the buffer of bytes up to and including a particular character
  • readString()Returns the buffer as a String
  • readStringUntil()Returns the buffer as a String up to and including a particular character
  • write()Writes bytes, chars, ints, bytes[], Strings

Related

Creative Commons License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.