Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dictNext(3)			  util/dict.h			   dictNext(3)

NAME
       dictNext	 - search for next value in dictionary.

SYNOPSIS
       #include	<util/dict.h>

       void *dictNext(dictCtx dict, char **id, void **plock);

ARGUMENTS
       dict - dictionary to iterate over.
       id - pointer to identifier of last item found, or
       pointer to NULL to retrieve first.
       plock - place for value lock (or	NULL).

DESCRIPTION
       Can  be used to iterate through values in the dictionary.  The order is
       the order of the	hash of	the  ids,  which  isn't	 usefully  externally.
       Will  return  the  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	dictReleaseLock(), the
       value will not be passed	to the	dictCleanupFunc	 callback  (see	 dict-
       Cleanup()).

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

RETURN VALUE
       plock - set to value lock.
       id - pointer to id of found value

SEE ALSO
       dictDestroy(3),	 dictCleanup(3),   dictReleaseLock(3),	dictRemove(3),
       dictNext(3), dictCreate(3), dictSetValue(3), dictModifyValue(3),	 dict-
       Search

ClearSilver			 12 July 2007			   dictNext(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dictNext&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help