optionFindValue(3)

💖 optionFindValue(3) — Programmer's Manual 💖

okay bestie, welcome to the optionFindValue(3) page from the Programmer's Manual — we're finding a hierarcicaly valued option instance today, and yes that spelling is staying exactly as it is, no cap. ✨

🌸 NAME 🌸

optionFindValue — find a hierarcicaly valued option instance 🫶

✨ SYNOPSIS ✨

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

const tOptionValue * optionFindValue(const tOptDesc * odesc, char const
* name, char const * val);

🦋 DESCRIPTION 🦋

This routine will find an entry in a nested value option or configurable. It searches through the list and returns a matching entry. Literally its whole job, and it ate. 💅

• odesc — an option with a nested arg type.
• name — name of value to find.
• val — 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. And yes, the original really trails off with @end itemize right there, so we're preserving that lil formatting moment too: @end itemize

🌈 SEE ALSO 🌈

The info documentation for the -lopts library. 📚

And the whole bestie roster:

• ao_string_tokenize(3)
• configFileLoad(3)
• optionFileLoad(3)
• optionFindNextValue(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),

---

Sign-off from the footer, bestie: this is optionFindValue(3) from the Programmer's Manual, dated 2018-08-26. Stay iconic, keep your nested values close, and may your errno always make sense. 🎀💖🦋