Serial.write()
Beschreibung
Schreibt binäre Daten an die serielle Schnittstelle. Diese Daten werden als ein Byte oder eine Reihe von Bytes gesendet. Zum Senden der Zeichen, die die Ziffern einer Zahl darstellen, verwende die print()-Funktion.
Syntax
_Serial_.write(val)
_Serial_.write(str)
_Serial_.write(buf, len)
Parameter
: Serielles Port-Objekt. Die Liste der verfügbaren seriellen Anschlüsse für jedes Board auf der Serial-Hauptseite._Serial_
: Ein Wert, der als einzelnes Byte gesendet werden soll.val
: Eine Zeichenfolge, die als Folge von Bytes gesendet werdenstr
- soll.
: Ein Array, das als Folge von Bytes gesendet werden soll.buf
: Die Anzahl der Bytes, die vom Array gesendet werden sollen.len
Rückgabewert
Gibt die Anzahl der geschriebenen Bytes zurück, das Lesen dieser Anzahl ist jedoch optional. Datentyp:
size_t
.Beispielcode
1void setup() {2 Serial.begin(9600);3 }4
5 void loop() {6 Serial.write(45); // Sende ein Byte mit dem Wert 457
8 int bytesSent = Serial.write("hello"); // Sende die Zeichenfolge "Hallo" und gib die Länge der Zeichenfolge zurück.9 }
Anmerkungen und Warnungen
Seit Arduino IDE 1.0 ist die serielle Übertragung asynchron. Wenn im Sendepuffer genügend freier Speicherplatz vorhanden ist, wird
_Serial_.write()
zurückgegeben, bevor Zeichen seriell übertragen werden. Wenn der Sendepuffer voll ist, wird _Serial_.write()
blockiert, bis im Puffer genügend Speicherplatz vorhanden ist. Um das Blockieren von Aufrufen von _Serial_.write()
zu vermeiden, kannst du zunächst den freien Speicherplatz im Sendepuffer mit überprüfen: availableForWrite().Suggest changes
The content on docs.arduino.cc is facilitated through a public GitHub repository. If you see anything wrong, you can edit this page here.
License
The Arduino documentation is licensed under the Creative Commons Attribution-Share Alike 4.0 license.