home | help
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  re-
     turned  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)

home | help