optionFindNextValue(3)

💖 NAME 💖

optionFindNextValue — find a hierarcicaly valued option instance. Yes bestie, that spelling is straight from the page, no cap. This is optionFindNextValue(3) from the Programmer’s Manual, and it’s here to help you find your way through nested option values like a total main character. 🫶

🦋 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 ✨

Okay so 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. Literally iconic behavior. 💅

The arguments are giving:

• odesc — an option with a nested arg type. That’s the starting energy.
• pPrevVal — the last entry. The previous one, bestie.
• name — name of value to find. Like the name tag at the function party.
• value — the matching value. The actual fit check.

🎀 RETURN VALUE 🎀

It returns a compound value structure. Slay. ✨

💅 ERRORS 💅

If things go sideways, 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 (yes, that little artifact is in the original too — keeping every crumb 🍓).

🌈 SEE ALSO 🌈

The info documentation for the -lopts library. Then the whole reference squad, no skips:

• ao_string_tokenize(3)
• configFileLoad(3)
• optionFileLoad(3)
• optionFindValue(3)
• optionFree(3)
• optionGetValue(3)
• optionLoadLine(3)
• optionMemberList(3)
• optionNextValue(3)
• optionOnlyUsage(3)
• optionPrintVersion(3)
• optionPrintVersionAndReturn(3)
• optionProcess(3)
• optionRestore(3)
• optionSaveFile(3)
• optionSaveState(3)
• optionUnloadNested(3)
• optionVersion(3)
• strequate(3)
• streqvcmp(3)
• streqvmap(3)
• strneqvcmp(3)
• strtransform(3),

---

That’s the whole page, bestie. This was optionFindNextValue(3) from the Programmer’s Manual, dated 2018-08-26. Byeee, go find that next value 💜✨