Name

readStringUntil()

Class

Serial

Description

Combination of readBytesUntil() and readString(). Returns null if it doesn't find what you're looking for.

Examples

  • // Example by Tom Igoe
    
    import processing.serial.*;
    
    int lf = 10;    // Linefeed in ASCII
    String myString = null;
    Serial myPort;  // The serial port
    
    void setup() {
      // List all the available serial ports
      printArray(Serial.list());
      // Open the port you are using at the rate you want:
      myPort = new Serial(this, Serial.list()[0], 9600);
      myPort.clear();
      // Throw out the first reading, in case we started reading 
      // in the middle of a string from the sender.
      myString = myPort.readStringUntil(lf);
      myString = null;
    }
    
    void draw() {
      while (myPort.available() > 0) {
        myString = myPort.readStringUntil(lf);
        if (myString != null) {
          println(myString);
        }
      }
    }
    
    

Syntax

  • serial.readStringUntil(inByte)

Parameters

  • serial(Serial) any variable of type Serial
  • inByte(int)character designated to mark the end of the data

Return

  • String