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

NAME

dictNext - search for next value in dictionary.

CONTENTS

Synopsis
Arguments
Description

SYNOPSIS

   

#include <util/dict.h>

   

void *dictNext(dictCtx dict, char **id, void **plock);

ARGUMENTS

dict - dictionary to iterate over.
id - pointer to identifier of last item found, or
pointer to NULL to retrieve first.
plock - place for value lock (or NULL).

DESCRIPTION

Can be used to iterate through values in the dictionary. The order is the order of the hash of the ids, which isn’t usefully externally. Will return the value if found, or NULL if not. If <plock> is non-NULL, then the lock returned in <plock> will be associated with the returned value. Until this lock is passed to dictReleaseLock(), the value will not be passed to the dictCleanupFunc callback (see dictCleanup()).

MT-Level: Safe if <dict> thread-safe.

RETURN VALUE

plock - set to value lock.
id - pointer to id of found value

SEE ALSO

dictDestroy(3), dictCleanup(3), dictReleaseLock(3), dictRemove(3), dictNext(3), dictCreate(3), dictSetValue(3), dictModifyValue(3), dictSearch
Search for    or go to Top of page |  Section 3 |  Main Index


ClearSilver DICTNEXT (3) 12 July 2007

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