empty is an empty slice.

length slice is the number of bytes in slice.

get slice i is the byte of slice' at index i.

• raises Invalid_argument

  if i is not an index of slice.

get_int8 slice i is slice's signed 8-bit integer starting at byte index i.

get_uint8 slice i is slice's unsigned 8-bit integer starting at byte index i.

get_int16_ne slice i is slice's native-endian unsigned 16-bit integer starting at byte index i.

get_int16_le slice i is slice's little-endian unsigned 16-bit integer starting at byte index i.

get_int16_be slice i is slice's big-endian unsigned 16-bit integer starting at byte index i.

get_int16_ne slice i is slice's native-endian signed 16-bit integer starting at byte index i.

get_int16_le slice i is slice's little-endian signed 16-bit integer starting at byte index i.

get_int16_be slice i is slice's big-endian signed 16-bit integer starting at byte index i.

get_int32_ne slice i is slice's native-endian 32-bit integer starting at byte index i.

get_int32_le slice i is slice's little-endian 32-bit integer starting at byte index i.

get_int32_be slice i is slice's big-endian 32-bit integer starting at byte index i.

get_int64_ne slice i is slice's native-endian 64-bit integer starting at byte index i.

get_int64_le slice i is slice's little-endian 64-bit integer starting at byte index i.

get_int64_be slice i is slice's big-endian 64-bit integer starting at byte index i.

set t i chr modifies t in place, replacing the byte at index i with chr.

• raises Invalid_argument

  if i is not a valid index in t.

set_int8 t i v sets t's signed 8-bit integer starting at byte index i to v.

set_uint8 t i v sets t's unsigned 8-bit integer starting at byte index i to v.

set_uint16_ne t i v sets t's native-endian unsigned 16-bit integer starting at byte index i to v.

set_uint16_le t i v sets t's little-endian unsigned 16-bit integer starting at byte index i to v.

set_uint16_le t i v sets t's big-endian unsigned 16-bit integer starting at byte index i to v.

set_uint16_ne t i v sets t's native-endian signed 16-bit integer starting at byte index i to v.

set_uint16_le t i v sets t's little-endian signed 16-bit integer starting at byte index i to v.

set_uint16_le t i v sets t's big-endian signed 16-bit integer starting at byte index i to v.

set_int32_ne t i v sets t's native-endian 32-bit integer starting at byte index i to v.

set_int32_ne t i v sets t's little-endian 32-bit integer starting at byte index i to v.

set_int32_ne t i v sets t's big-endian 32-bit integer starting at byte index i to v.

set_int32_ne t i v sets t's native-endian 64-bit integer starting at byte index i to v.

set_int32_ne t i v sets t's little-endian 64-bit integer starting at byte index i to v.

set_int32_ne t i v sets t's big-endian 64-bit integer starting at byte index i to v.

blit src dst copies all bytes of src into dst.

fill t off len chr modifies t in place, replacing len characters with chr, starting at off.

• raises Invalid_argument

  if off and len do not designate a valid range of t.

sub slice ~off ~len does not allocate a new bigstring, but instead returns a new view into t.buf starting at off, and with length len.

Note that this does not allocate a new buffer, but instead shares the buffer of t.buf with the newly-returned slice.

shift slice n is sub slice n (length slice - n) (see sub for more details).

sub_string slice ~off ~len returns a string of length len containing the bytes of slice starting at off.

• raises Invalid_argument

  if off and len do not designate a valid range of t.

to_string slice is equivalent to sub_string slice ~off:0 ~len:(length slice).

is_empty bstr is length bstr = 0.

of_string str returns a new t that contains the contents of the given string str.

string ~off ~len str is the sub-buffer of str that starts at position off (defaults to 0) and stops at position off + len (defaults to String.length str). str is fully-replaced by a fresh allocated t.

• raises Invalid_argument

  if off and len do not designate a valid range of str.

overlap x y returns the size (in bytes) of what is physically common between x and y, as well as the position of y in x and the position of x in y.