socket_read

socket_read -- Liest höchstens die angegebene Anzahl Bytes von einem Socket.

Beschreibung

string socket_read ( resource socket, int length [, int type])

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_read( ) liest von dem Socket socket , der entweder mit socket_create( ) oder mit socket_accept( ) erzeugt wurde . Die Anzahl Bytes , die höchstens gelesen wird , wird in dem Parameter length angegeben . Anderenfalls können Sie mit \r , \n , or \0 den Lesevorgang beenden ( dies ist abhängig von dem Parameter type , siehe weiter unten ) .

socket_read( ) gibt bei Erfolg die Daten als String 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_read() kann auch einen leeren String zurückgeben (""), der das Ende der Kommunikation anzeigt (z.B. wenn der entfernte Host die Verbindung beendet hat).

Der optionale Parameter type ist eine vordefinierte Konstante :



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