DragonFly On-Line Manual Pages

MTBL_ITER(3)                                                      MTBL_ITER(3)

NAME
       mtbl_iter - iterate over a sequence of key-value pairs

SYNOPSIS
       #include <mtbl.h>

       mtbl_res
       mtbl_iter_next(struct mtbl_iter *it,
               const uint8_t * *key, size_t *len_key,
               const uint8_t * *val, size_t *len_val);

       void
       mtbl_iter_destroy(struct mtbl_iter **it);

DESCRIPTION
       The mtbl_iter interface is used to return a sequence of one or more
       key-value pairs. Once the caller obtains an mtbl_iter object,
       mtbl_iter_next() should be repeatedly called on it until there are no
       more key-value entries to retrieve, at which point the iterator object
       must be freed by calling mtbl_iter_destroy().

RETURN VALUE
       mtbl_iter_next() returns mtbl_res_success if a key-value entry was
       successfully retrieved, in which case key and val will point to buffers
       of length len_key and len_val respectively. The value mtbl_res_failure
       is returned if there are no more entries to read, or if the it argument
       is NULL.

SEE ALSO
       mtbl_source(3)

                                  01/31/2014                      MTBL_ITER(3)