Serial.write()

설명

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.

문법

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

Arduino Mega also supports:

Serial1, Serial2, Serial3 (in place of Serial)

매개변수

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

반환

size_t

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

예제 코드

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

Notes and Warnings

As of Arduino IDE 1.0, serial transmission is asynchronous. If there is enough empty space in the transmit buffer, Serial.write() will return before any characters are transmitted over serial. If the transmit buffer is full then Serial.write() will block until there is enough space in the buffer. To avoid blocking calls to Serial.write(), you can first check the amount of free space in the transmit buffer using availableForWrite().