Module Luv.BufferSource

Data buffers.

Basics

Buffers with C storage.

These are OCaml bigstrings (char bigarrays). Roughly speaking, they correspond to C buffers referenced by pointers of type char*, but also know their own size.

In addition to being usable with the functions in this module, the type is compatible with at least the following libraries:

Sourceval create : int -> t

Allocates a fresh buffer of the given size.

Sourceval size : t -> int

Evaluates to the size of the given buffer.

Sourceval get : t -> int -> char

Luv.Buffer.get buffer index retrieves the character in buffer at index.

Can also be written as buffer.{index}.

Sourceval unsafe_get : t -> int -> char

Like Luv.Buffer.get, but does not perform a bounds check.

Sourceval set : t -> int -> char -> unit

Luv.Buffer.set buffer index value sets the character in buffer at index to value.

Can also be written as buffer.{index} <- value.

Sourceval unsafe_set : t -> int -> char -> unit

Like Luv.Buffer.set, but does not perform a bounds check.

Sourceval sub : t -> offset:int -> length:int -> t

Luv.Buffer.sub buffer ~offset ~length creates a view into buffer that starts at the given offset and has the given length.

No data is copied.

Sourceval blit : source:t -> destination:t -> unit

Copies data from source to destination.

The amount of data copied is the minimum of the two buffers' size.

To copy part of a buffer, use Luv.Buffer.sub to create a view, and pass the view to Luv.Buffer.blit.

Sourceval fill : t -> char -> unit

Fills the given buffer with the given character.

Conversions

Sourceval to_string : t -> string

Creates a string with the same contents as the given buffer.

Sourceval to_bytes : t -> bytes

Creates a bytes buffer with the same contents as the given buffer.

Sourceval from_string : string -> t

Creates a buffer from a string.

Sourceval from_bytes : bytes -> t

Creates a buffer from bytes.

Converting blits

Sourceval blit_to_bytes : t -> bytes -> destination_offset:int -> unit

Copies data from a buffer to a bytes buffer.

Sourceval blit_from_bytes : t -> bytes -> source_offset:int -> unit

Copies data from a bytes buffer to a buffer.

Sourceval blit_from_string : t -> string -> source_offset:int -> unit

Copies data from a string to a buffer.

Lists of buffers

Many Luv functions, such as Luv.File.write, work with lists of buffers (i.e., they do scatter-gather I/O). These are helpers for working with buffer lists.

Sourceval total_size : t list -> int

Evaluates to the sum of the sizes of the buffers in the list.

Sourceval drop : t list -> int -> t list

drop buffers count drops the first count bytes from buffers.

For example, if buffers contains two buffers of size 16, drop buffers 18 will evaluate to a list that has lost the reference to the first buffer, and contains only a view into the second buffer of size 14.