DragonFly On-Line Manual Pages

skipNext(3)                     util/skiplist.h                    skipNext(3)

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
       skipDelete(3), skipFreeList(3), skipRelease(3), skipInsert(3),
       skipSearch(3), skipNext(3), skipNewList

ClearSilver                      12 July 2007                      skipNext(3)