dwww Home | Manual pages | Find package

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
       tOptionValue * pPrevVal, char const * name, char const * value);

DESCRIPTION
       This routine will find the next entry in a nested value option or  con-
       figurable.   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),  option-
       FindValue(3), optionFree(3), optionGetValue(3), optionLoadLine(3),  op-
       tionMemberList(3), optionNextValue(3), optionOnlyUsage(3), optionPrint-
       Version(3), optionPrintVersionAndReturn(3), optionProcess(3), optionRe-
       store(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3),
       optionVersion(3),     strequate(3),     streqvcmp(3),     streqvmap(3),
       strneqvcmp(3), strtransform(3),

                                  2022-05-24            optionFindNextValue(3)

Generated by dwww version 1.15 on Sat Jun 29 11:18:27 CEST 2024.