DragonFly On-Line Manual Pages
MTBL_SOURCE(3) MTBL_SOURCE(3)
NAME
mtbl_source - obtain key-value entries from a data source
SYNOPSIS
#include <mtbl.h>
struct mtbl_iter *
mtbl_source_iter(const struct mtbl_source *s);
struct mtbl_iter *
mtbl_source_get(const struct mtbl_source *s, const uint8_t *key, size_t len_key);
struct mtbl_iter *
mtbl_source_get_prefix(
const struct mtbl_source *s,
const uint8_t *prefix, size_t len_prefix);
struct mtbl_iter *
mtbl_source_get_range(
const struct mtbl_source *s,
const uint8_t *key0, size_t len_key0,
const uint8_t *key1, size_t len_key1);
mtbl_res
mtbl_source_write(const struct mtbl_source *s, struct mtbl_writer *w);
void
mtbl_source_destroy(struct mtbl_source **s);
DESCRIPTION
The mtbl_source iterface provides an abstraction for reading key-value
entries from mtbl data sources.
mtbl_source_iter() provides an iterator over all of the entries in the
data source.
mtbl_source_get() provides an exact match iterator which returns all
entries whose key matches the key provided in the arguments key and
len_key.
mtbl_source_get_prefix() provides a prefix iterator which returns all
entries whose keys start with prefix and are at least len_prefix bytes
long.
mtbl_source_get_range() provides a range iterator which returns all
entries whose keys are between key0 and key1 inclusive.
mtbl_source_write() is a convenience function for reading all of the
entries from a source and writing them to an mtbl_writer object. It is
equivalent to calling mtbl_writer_add() on all of the entries returned
from mtbl_source_iter().
RETURN VALUE
mtbl_source_iter(), mtbl_source_get(), mtbl_source_get_prefix(), and
mtbl_source_get_range() return mtbl_iter objects.
mtbl_source_write() returns mtbl_res_success if all of the entries in
the data source were successfully written to the mtbl_writer argument,
and mtbl_res_failure otherwise.
SEE ALSO
mtbl_iter(3)
01/31/2014 MTBL_SOURCE(3)