array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.socket-write.php', 1 => 'socket_write', 2 => 'Schreibt in einen Socket', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Socket-Funktionen', ), 'prev' => array ( 0 => 'function.socket-strerror.php', 1 => 'socket_strerror', ), 'next' => array ( 0 => 'function.socket-wsaprotocol-info-export.php', 1 => 'socket_wsaprotocol_info_export', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/sockets/functions/socket-write.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_write

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_write — Schreibt in einen Socket

Beschreibung

socket_write(Socket $socket, string $data, ?int $length = null): int|false

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

Parameter-Liste

socket

data

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 data, wird sie stillschweigend auf die Größe von data gekürzt.

Rückgabewerte

Gibt die Anzahl der erfolgreich in den Socket geschriebenen Bytes zurück. Bei einem Fehler 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.

Changelog

Version Beschreibung
8.0.0 socket ist nun eine Socket-Instanz; vorher war es eine resource.
8.0.0 length ist nun ein Nullable-Typ.

Anmerkungen

Hinweis:

socket_write() schreibt nicht notwendigerweise alle Bytes aus data. Abhängig von den Puffern im Netzwerk usw. kann es sein, dass nur eine bestimmte Datenmenge, sogar nur ein Byte, geschrieben wird, obwohl data größer ist. Um sicherzustellen, dass der Rest von data übertragen wird, muss eine Schleife verwendet werden.

Siehe auch