Function.socket-write
Aus PHP-Wiki
socket_write — Schreibt in einen Socket
Inhaltsverzeichnis |
Beschreibung
int socket_write ( resource $socket , string $buffer [, int $length ] )
Die Funktion socket_write() schreibt aus dem Puffer
buffer
in den Socket socket
.
Parameter-Liste
- 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.
Rückgabewerte
Gibt die Anzahl der erfolgreich in den Socket geschriebenen Bytes zurück
oder FALSE, falls ein Fehler aufgetreten ist. 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
zurückgibt, 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.
Anmerkungen
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.