socket_write

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( ) .