php/archived-doc-en
1
0
Fork 0
mirror of https://github.com/php/doc-en.git synced 2026-03-23 23:32:18 +01:00
Code Issues Packages Projects Releases Wiki Activity

Clarify socket_write() (#4474)

Browse Source 
The note was not parseable for me, and the use of "buffer" for both the
network buffers and the input data (in the same sentence) made it too
confusing for me to interpret initially.
This commit is contained in:
Niels Dossche
2025-02-20 18:43:47 +01:00
committed by GitHub
parent c558c3af38
commit 2ca1058473
1 changed files with 6 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
reference/sockets/functions/socket-write.xml
View File

@@ -46,8 +46,8 @@
<para>
The optional parameter <parameter>length</parameter> can specify an
alternate length of bytes written to the socket. If this length is
greater than the buffer length, it is silently truncated to the length
of the buffer.
greater than <parameter>data</parameter>'s length,
it is silently truncated to the length of <parameter>data</parameter>.
</para>
</listitem>
</varlistentry>
@@ -102,10 +102,11 @@
<note>
<para>
<function>socket_write</function> does not necessarily write all bytes
from the given buffer. It's valid that, depending on the network
from <parameter>data</parameter>. It's valid that, depending on the network
buffers etc., only a certain amount of data, even one byte, is written
though your buffer is greater. You have to watch out so you don't
unintentionally forget to transmit the rest of your data.
despite <parameter>data</parameter> being longer.
A loop must be used to ensure that the rest of <parameter>data</parameter>
is transmitted.
</para>
</note>
</refsect1>