Many network protocols are line-based to allow for easy and efficient implementation. For this reason, a separate entry point ReadLine is provided for reading text one line at a time over a socket connection.

The procedure ReadLine is similar to the procedure Sockets[Read], however, it stops reading upon encountering the first newline (ASCII 10) character in the data. Like Sockets[Read], the procedure ReadLine is used to read textual data from a socket. It cannot be used to read data containing null bytes. (To read binary data, see Sockets[ReadBinary].)

The argument sid must be a valid socket ID for an open socket connection. The optional argument timeout indicates the number of seconds the call to ReadLine should block before timing out and returning the value false.

The ReadLine procedure obeys the persistent timeout protocol. (See Sockets/timeout.)

$\mathrm{with}\left(\mathrm{Sockets}\right)\:$

$\mathrm{sid}≔\mathrm{Open}\left(''localhost''\,''echo''\right)$

$0$

$\mathrm{Write}\left(\mathrm{sid}\,''The\; higher,\; the\; fewer!\backslash n''\right)$

$23$

$\mathrm{ReadLine}\left(\mathrm{sid}\right)$

$''The\; higher,\; the\; fewer!''$

$\mathrm{Close}\left(\mathrm{sid}\right)$

$\mathrm{true}$

$\mathrm{sid}≔\mathrm{Open}\left(''mantis''\,''echo''\right)$

$0$

$\mathrm{Write}\left(\mathrm{sid}\,''The\; higher,\backslash nthe\; fewer!\backslash n''\right)$

$23$

$\mathrm{ReadLine}\left(\mathrm{sid}\right)$

$''The\; higher,''$

$\mathrm{ReadLine}\left(\mathrm{sid}\right)$

$''the\; fewer!''$

$\mathrm{Close}\left(\mathrm{sid}\right)$

$\mathrm{true}$