PHP Handbuch
Zurück |  | Nach vorne

# socket_write

(PHP 4 >= 4.1.0)

socket_write -- Schreibt in den Socket

## Beschreibung

int socket_write ( resource socket, string buffer [, int length])

Warnung
Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und alles Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.

Die Funktion socket_write() schreibt aus dem Puffer `buffer` in den Socket `socket`.

Mit dem optionalen Parameter `length` kann man alternativ eine Anzahl von Bytes angeben, die in den Socket geschrieben wrden 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 oder `FALSE`, falls ein Fehler aufgetreten ist. Der Fehlercode kann mit der Funktion socket_last_error() abgefragt werden. Dieser Fehlercode kann an die Funktion socket_strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

> Anmerkung: 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, nicht dass Sie unabsichtlich vergessen, den Rest Ihrer Daten zu senden.

> Anmerkung: Es durchaus möglich, dass socket_write() 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.

See also socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_read() und socket_strerror().

Zurück | Zum Anfang | Nach vorne
socket_strerror | Nach oben | socket_writev