(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_write — Schreibt in einen Socket
$socket
, string $buffer
[, int $length
= 0
] ) : int
Die Funktion socket_write() schreibt aus dem Puffer
buffer
in den Socket socket
.
socket
buffer
Der Puffer, dessen Inhalt geschrieben werden soll.
length
Mit dem optionalen Parameter length
kann man
alternativ eine Anzahl von Bytes angeben, die in den Socket geschrieben
werden sollen. Falls diese Anzahl größer ist, als der Puffer, wird sie
stillschweigend auf die Puffergröße gekürzt.
Gibt die Anzahl der erfolgreich in den Socket geschriebenen Bytes zurück
Im Fehlerfall wird FALSE
zurückgegeben.. Der Fehlercode kann mit der
Funktion socket_last_error() ermittelt werden. Dieser Fehlercode
kann an die Funktion socket_strerror() übergeben
werden, um eine textuelle Beschreibung des Fehlers zu erhalten.
Hinweis:
Es ist durchaus möglich, dass socket_write() den Wert 0 zurckgibt, was bedeutet, dass kein einziges Byte geschrieben wurde. Vergewissern Sie sich, dass Sie den === Operator benutzen, um im Falle eines Fehlers auf
FALSE
zu testen.
Hinweis:
socket_write() schreibt nicht notwendigerweise alle Bytes aus dem angegebenen Puffer. Es ist auch möglich, dass, abhängig von den Puffern im Netzwerk usw., nur eine bestimmte Datenmenge, sogar auch nur ein Byte, geschrieben wird, obwohl der Puffer größer ist. Dies müssen Sie beobachten, damit Sie nicht versehentlich versäumen, den Rest Ihrer Daten zu senden.