man rbuf (Fonctions bibliothèques) - a robust string implementation
NAME
rbuf - a robust string implementation
SYNOPSIS
#include <roy.h>
DESCRIPTION
The rbuf is a string/buffer class which can be used to store variable length, auto-expanding strings, or binary buffers. A security feature of one addional byte at the end of the buffer keeps programs from violating thier segment boundries or overflowing the buffer. This byte is hidden from the programmer until code looking for the terminating '\0' finds it.
The RBuf struct is opaque, you should use rbuf_str(3) to get the C style string out, and rbuf_len(3) to get the length of the buffer.
A call to rbuf_str(3) returns a pointer to the buffer that will always be '\0' terminated one byte passed the appearent buffer length. Do not pass around references to this buffer if you are modifing the rbuf as it may become obsolete with subsequent api calls. This buffer should also never be modified directly, always use calls to one of the rbuf functions.
SEE ALSO
rbuf_append(3), rbuf_append_char(3), rbuf_append_data(3), rbuf_append_rbuf(3), rbuf_append_sprintf(3), rbuf_append_str(3), rbuf_append_vsprintf(3), rbuf_auto(3), rbuf_down(3), rbuf_empty(3), rbuf_equal(3), rbuf_equal_data(3), rbuf_equal_rbuf(3), rbuf_equal_rbuf_len(3), rbuf_equal_rbufcase(3), rbuf_equal_str(3), rbuf_equal_str_len(3), rbuf_equal_strcase(3), rbuf_erase(3), rbuf_float(3), rbuf_free(3), rbuf_hash(3), rbuf_insert(3), rbuf_last(3), rbuf_len(3), rbuf_long(3), rbuf_new(3), rbuf_new_with_sprintf(3), rbuf_own(3), rbuf_prepend(3), rbuf_prepend_char(3), rbuf_prepend_data(3), rbuf_prepend_rbuf(3), rbuf_prepend_str(3), rbuf_rdonly(3), rbuf_set_to(3), rbuf_split(3), rbuf_sprintf(3), rbuf_str(3), rbuf_truncate(3), rbuf_up(3), roy(3)