GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MTBL_SOURCE (3)

.ds Aq ’

NAME

mtbl_source - obtain key-value entries from a data source

CONTENTS

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)

Search for    or go to Top of page |  Section 3 |  Main Index


& MTBL_SOURCE (3) 01/31/2014

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.