Sources can offer a list of ways to read them, in order of preference.

single_read src buf reads one or more bytes into buf.

It returns the number of bytes read (which may be less than the buffer size even if there is more data to be read). single_read src just makes a single call to src#read_into (and asserts that the result is in range).

• Use read_exact instead if you want to fill buf completely.
• Use Buf_read.line to read complete lines.
• Use copy to stream data directly from a source to a sink.

buf must not be zero-length.

• raises End_of_file

  if there is no more data to read

read_exact src dst keeps reading into dst until it is full.

• raises End_of_file

  if the buffer could not be filled.

read_methods flow is a list of extra ways of reading from flow, with the preferred (most efficient) methods first.

If no method is suitable, read should be used as the fallback.

string_source s is a source that gives the bytes of s.

cstruct_source cs is a source that gives the bytes of cs.

Consumer base class.

write dst bufs writes all bytes from bufs.

You should not perform multiple concurrent writes on the same flow (the output may get interleaved).

This is a low level API. Consider using:

• Buf_write to combine multiple small writes.
• copy for bulk transfers, as it allows some extra optimizations.

copy src dst copies data from src to dst until end-of-file.

copy_string s = copy (string_source s)

buffer_sink b is a sink that adds anything sent to it to b.

To collect data as a cstruct, use Buf_read instead.

shutdown t cmd indicates that the caller has finished reading or writing t (depending on cmd).

This is useful in some protocols to indicate that you have finished sending the request, and that the remote peer should now send the response.

Alias of Generic.close.