NAME

       mtbl_varint - Variable-width encoding and decoding of 32 and 64 bit integers

SYNOPSIS

       #include <mtbl.h>

       unsigned mtbl_varint_length(uint64_t value);

       unsigned mtbl_varint_length_packed(const uint8_t *buf, size_t len_buf);

       size_t mtbl_varint_encode32(uint8_t *ptr, uint32_t value);

       size_t mtbl_varint_encode64(uint8_t *ptr, uint64_t value);

       size_t mtbl_varint_decode32(const uint8_t *ptr, uint32_t *value);

       size_t mtbl_varint_decode64(const uint8_t *ptr, uint64_t *value);

DESCRIPTION

       mtbl_varint_encode32() and mtbl_varint_encode64() write the 32 or 64 bit quantity,
       respectively, in the argument value to the buffer in the argument dst. The quantity will
       be written in using a variable-width encoding that uses at most 5 bytes for a 32 bit
       quantity or 10 bytes for a 64 bit quantity.

       mtbl_varint_decode32() and mtbl_varint_decode64() read the 32 or 64 bit varint quantity,
       respectively, in the argument ptr. The quantity read will be placed in the argument value.

       Bounds checking must be performed by the caller.

RETURN VALUE

       mtbl_varint_encode32() and mtbl_varint_encode64() return the number of bytes written to
       dst.

       mtbl_varint_decode32() and mtbl_varint_decode64() return the number of bytes read from
       ptr.

       mtbl_varint_length() returns the number of bytes that its argument value would require in
       the variable-width encoding.

       mtbl_varint_length_packed() returns the number of bytes consumed by the variable-width
       encoded quantity at its argument data. It will read at most len_buf bytes from data. The
       value 0 is returned if a valid varint is not present.

                                            01/31/2014                             MTBL_VARINT(3)