skipNext (3) - Linux Manuals

skipNext: find next item.

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.