man rbuf_empty (Fonctions bibliothèques) - find out if an rbuf is holding anything
NAME
rbuf_empty, rbuf_not_empty - find out if an rbuf is holding anything
SYNOPSIS
#include <roy.h>
int rbuf_empty (RBuf *buf);
int rbuf_not_empty (RBuf *buf);
DESCRIPTION
Unlike rbuf_len(3) these two api calls do not require buf to be non NULL. If buf is not empty the programmer can assume that buf is non NULL and has data in it's buffer.
Programmers should not confuse rbuf_empty(3) with rbuf_truncate(3). A call to rbuf_empty(3) does a check for empty while a call to rbuf_truncate(3) can be used to empty an rbuf.
RETURN VALUE
A call to rbuf_empty(3) returns TRUE if buf is NULL or buf's length is zero (0). Otherwise, FALSE is returned.
A call to rbuf_not_empty(3) returns TRUE if buf is non NULL and buf's length is non zero (0). Otherwise, FALSE is returned. This call is equivalant to !rbuf_empty(3).
ERRORS
These calls do not error.
MACRO
These two calls are implmented using macros.
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_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)