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

FreeBSD Manual Pages

  
 
  

home | help
optionNextValue(3)	       Programmer's Manual	      optionNextValue(3)

NAME
     optionNextValue - get the next value from a hierarchical list

SYNOPSIS
     #include <your-opts.h>
     cc [...] -o outfile infile.c -lopts [...]

     const  tOptionValue * optionNextValue(const tOptionValue * pOptValue, const
     tOptionValue * pOldValue);

DESCRIPTION
     This routine will return the next entry after the entry passed in.  At  the
     end  of  the list, NULL will be returned.	If the entry is not found on the
     list, NULL will be returned and "errno" will be set to EINVAL.  The  "pOld-
     Value"  must have been gotten from a prior call to this routine or to "opi-
     tonGetValue()".

     pOptValue
	    a hierarchcal list value

     pOldValue
	    a value from this list

RETURN VALUE
     a compound value structure

ERRORS
     The returned result is NULL and errno is set:

     EINVAL - the pOptValue does not point to a valid hierarchical option  value
     or pOldValue does not point to a member of that option value.

     ENOENT - the supplied pOldValue pointed to the last entry.  @end itemize

SEE ALSO
     The info documentation for the -lopts library.
     ao_string_tokenize(3),  configFileLoad(3),  optionFileLoad(3),  optionFind-
     NextValue(3), optionFindValue(3), optionFree(3), optionGetValue(3), option-
     LoadLine(3),   optionMemberList(3),   optionOnlyUsage(3),	 optionPrintVer-
     sion(3),	 optionPrintVersionAndReturn(3),   optionProcess(3),   optionRe-
     store(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3), op-
     tionVersion(3), strequate(3),  streqvcmp(3),  streqvmap(3),  strneqvcmp(3),
     strtransform(3),

				   2026-07-30		      optionNextValue(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=optionNextValue&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help