Documentation

Create a new buffer of the specified initial capacity.

Prepares the buffer to be filled with at maximum the specified amount of bytes, then uses the pointer-action to populate it. It is your responsibility to ensure that the action does not exceed the space limit.

The pointer-action returns the amount of bytes it actually writes to the buffer. That amount then is used to move the buffer's cursor accordingly. It can also produce some result, which will then be emitted by push.

It also aligns or grows the buffer if required.

Push a byte array into the buffer.

Push a storable value into the buffer.

Pulls the specified amount of bytes from the buffer using the provided pointer-action, freeing the buffer from the pulled bytes afterwards.

In case the buffer does not contain enough bytes yet, it will block waiting.

Pulls the specified amount of bytes.

Pulls a storable value.

Get how much space is occupied by the buffer's data.

Create a bytestring representation without modifying the buffer.