NAME
rbuf_sprintf - creating formatted rbuf's
SYNOPSIS
#include <roy.h>
void rbuf_sprintf (RBuf *buf, const char *format, ...);
void rbuf_append_sprintf (RBuf *buf, const char *format, ...);
void rbuf_append_vsprintf (RBuf *buf, const char *format, va_list args);
RBuf * rbuf_new_with_sprintf (const char *format, ...);
DESCRIPTION
These functions are used to insert formatted strings into an RBuf.
A call to rbuf_sprintf(3) resets the current contents of the rbuf with the formatted string.
A call to rbuf_append_sprintf(3) appends the formatted string to the rbuf.
A call to rbuf_append_vsprintf(3) is identical to rbuf_append_sprintf(3) except that a *va_list is used as the arguments to the formatted string *format.
A call to rbuf_new_with_sprintf(3) creates a new rbuf with its buffer set to the formatted string.
RBUF FORMAT SPECIFICATION
The RBuf sprintf calls all implement %b as a format specification for rufs.
RETURN VALUE
All these calls with the exception of rbuf_new_with_sprintf(3) have no return value. rbuf_new_with_sprintf(3) returns an rbuf struct for use with other rbuf calls. The programmer should free this rbuf a call to rbuf_free(3) when he/she is done using the rbuf.
ERRORS
These calls do not error.
FUNCTION
All rbuf_sprintf(3) style api calls are implemented using functions.
SEE ALSO
rbuf(3), 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_str(3), rbuf_truncate(3), rbuf_up(3), roy(3)