package gapi-ocaml

  1. Overview
  2. Docs
Legend:
Library
Module
Module type
Parameter
Class
Class type

A sub stream is the part of the whole stream from the current position * to an arbitrary other position that is determined by len and * delimiter. len specifies the maximum length of the sub stream. * delimiter is an arbitrary string that indicates the end of the * sub stream (the delimiter is not part of the sub stream; i.e. the * sub stream ends immediately before the delimiter). * * While reading from the sub stream, not only the current position of * the sub stream moves, but also the current position of the main * stream. This means that it must be avoided to read data from the * main stream while the sub stream is in use. The typical pattern * is: * - Read from the main stream until the beginning of a section is * recognized * - Create a sub stream at this point * - Read from the sub stream until EOF * - Continue reading the main stream. The next character of the main * stream is exactly the character following the EOF of the sub stream

The normal input operations work as usual. The window is moved after * every read sequence of bytes by exactly the number of bytes, and * if the window length becomes smaller than the block size, it will * be ensured that the window will be enlarged to the block size (or * to the rest of the stream until EOF, whatever is smaller).

method block_size : int

The block size of the stream

method window : Netbuffer.t

The look-ahead window. The first byte of the window is the byte that * would be read next by input_char. The length of the window is returned * by the method window_length. This length may be smaller than the * current length of the netbuffer, i.e. the netbuffer may contain * additional data that must be ignored.

method want : int -> unit

Increases the length of the window such that the length is at least * the passed number of bytes or that the window reaches EOF (whatever * happens first).

method want_another_block : unit -> unit

The same as: want block_size

method window_length : int

Returns the length of the window

method window_at_eof : bool

Whether the window is at eof

method skip : int -> unit

Skip the n bytes of the stream. It is not an error to skip more bytes * than available in the remaining stream.

OCaml

Innovation. Community. Security.