skipNext 3 "12 July 2007" "ClearSilver" "util/skiplist.h"
....
NAME
skipNext - find next item.
SYNOPSIS
.Ss
#include <util/skiplist.h>
.Se
.Ss
void *skipNext(skipList list, UINT32 *pkey, void **plock);
.Se
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"
skipDelete "(3), "skipFreeList "(3), "skipRelease "(3), "skipInsert "(3), "skipSearch "(3), "skipNext "(3), "skipNewList