write()

Description

Writes binary data to the serial port. This data is sent as a byte or series of bytes; to send the characters representing the digits of a number use the print() function instead.

Syntax


Serial.write(val)
Serial.write(str)
Serial.write(buf, len)


Parameters

val: a value to send as a single byte
str: a string to send as a series of bytes
buf: an array to send as a series of bytes
len: the length of the buffer

Returns

byte: write() will return the number of bytes written, though reading that number is optional

Example

void setup(){
  Serial.begin(9600);
}

void loop(){
  Serial.write(45); // send a byte with the value 45

   int bytesSent = Serial.write(“hello”); // send the string “hello” and 
                                          // return the length of the string.
}

See also

－ Serial
－ available()
－ begin()
－ end()
－ find()
－ findUntil()
－ flush()
－ parseFloat()
－ parseInt()
－ peek()
－ print()
－ println()
－ read()
－ readBytes()
－ readBytesUntil()
－ setTimeout()
－ serialEvent()

Language 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.