optionFindNextValue

Section: Programmer's Manual (3) Updated: 2010-02-10 Local index Up

NAME

optionFindNextValue - find a hierarcicaly valued option instance

SYNOPSIS

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

const tOptionValue* optionFindNextValue(const tOptDesc* pOptDesc, const tOptionValue* pPrevVal, char const* name, char const* value);

DESCRIPTION

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

pOptDesc: 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

This document was created by man2html, using the manual pages.
Time: 21:51:48 GMT, April 16, 2011