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

FreeBSD Manual Pages

  
 
  

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

NAME
     optionFindNextValue - find a hierarcicaly valued option instance

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

     const tOptionValue * optionFindNextValue(const tOptDesc * odesc, const tOp-
     tionValue * pPrevVal, char const * name, char const * value);

DESCRIPTION
     This  routine  will find the next entry in a nested value option or config-
     urable.  It will search through the list and return  the  next  entry  that
     matches the criteria.

     odesc  an option with a nested arg type

     pPrevVal
	    the last entry

     name   name of value to find

     value  the matching value

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.

     ENOENT - no entry matched the given name.	@end itemize

SEE ALSO
     The info documentation for the -lopts library.
     ao_string_tokenize(3),  configFileLoad(3),  optionFileLoad(3),  optionFind-
     Value(3), optionFree(3), optionGetValue(3),  optionLoadLine(3),  optionMem-
     berList(3),  optionNextValue(3), optionOnlyUsage(3), optionPrintVersion(3),
     optionPrintVersionAndReturn(3), optionProcess(3), optionRestore(3), option-
     SaveFile(3), optionSaveState(3),  optionUnloadNested(3),  optionVersion(3),
     strequate(3), streqvcmp(3), streqvmap(3), strneqvcmp(3), strtransform(3),

				   2026-07-30		  optionFindNextValue(3)

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

home | help