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_ITER (3)

.ds Aq ’

NAME

mtbl_iter - iterate over a sequence of key-value pairs

CONTENTS

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)

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


& MTBL_ITER (3) 01/31/2014

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