bytebuf.h

#ifndef BYTEBUF_H
#define BYTEBUF_H

/* Intended as a replacement for traditional C-strings
 Backwards compatible with traditional C-strings, as still internally NUL terminated.
 There is no truncate in these APIs, add a new bytebuf_cpy_truncate() if needed. */

struct bytebuf
{
    size_t size; /* Size in bytes */
    size_t len;  /* Length in bytes that are in use */
    uint8 * buf; /* Buffer, this is +1 to allow a NUL terminating byte after the size */
};

/* Returns 0 on success, or an errno value */
int bytebuf_alloc(struct bytebuf * buf, size_t size);
int bytebuf_free(struct bytebuf * const buf);

/* Returns 0 on success, or EF2BIG if no space, EFAULT if any pointers are bad */
int bytebuf_cpy(struct bytebuf * const dest, const struct bytebuf * src);

/* Returns 0 on success, or EF2BIG if no space, EFAULT if any pointers are bad */
int bytebuf_cat(struct bytebuf * const dest, const struct bytebuf * src);

/* Returns 0 on success, or ENOMEM, or EFAULT if any pointers are bad */
int bytebuf_dup(struct bytebuf * const dest, const struct bytebuf * src);

/* Returns 0 on success, or EFAULT if any pointers are bad */
int bytebuf_set(struct bytebuf * const dest, uint8 value);

#endif