skipNext

Langue: en

Version: 298859 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

skipNext - find next item.

SYNOPSIS

 #include <util/skiplist.h>
 
 
 void *skipNext(skipList list, UINT32 *pkey, void **plock);
 
 
 

ARGUMENTS

list - list to search in.
pkey - pointer to previous key (0 to start).
plock - place for value lock (or NULL).

DESCRIPTION

Searches in list <list> for item with key next larger that the one in <pkey>, and returns its 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 skipRelease(), the value will not be freed with the freeValue callback (see skipNewList()).

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

RETURN VALUE

pkey - set to new key.
plock - set to value lock.

SEE ALSO

skipInsert(3), skipDelete(3), skipSearch(3), skipNext(3), skipFreeList(3), skipNewList(3), skipRelease