ECONF_SETEXTVALUE(3)

📦 version 0.8.4, in alpine 3.23, alpine 3.24, nixpkgs unstable, ubuntu stonking

💖 ECONF_SETEXTVALUE(3) 💖

okay bestie, sit down, hydrate, because we're talking about libeconf — yes, the manual page, from the libeconf Manual, and she is giving documentation. no cap.

✨ NAME ✨

econf_setExtValue — set extended value for a key in a configuration file structure 🎀

🌸 SYNOPSIS 🌸

#include <libeconf.h>
#include <libeconf_ext.h>

int econf_setExtValue(econf_file *key_file, const char *group,
const char *key, const econf_ext_value *value);

🦋 DESCRIPTION 🦋

so the econf_setExtValue() function adds or modifies a key's value in the configuration file structure referenced by key_file. literally what it does. 💅

and here's the cute part — this one lets you set the value using the full econf_ext_value structure, which is carrying extra metadata like the file source, comments and line number. it's giving ✨extra✨. yes, the whole structure. she's thorough like that.

ok wait, actual important plot twist: the function cannot be used for setting the value. values have to be set via econf_set<Type>Value. i know. i know!! that's what it says. read it again if you need to, bestie, i'll wait 🫶

the key gets set within the specified group. and if group is NULL or an empty string, the key goes into the global section instead. no group? no problem, global girl. 🌈

now the parameters, one by one, because we're thorough in this house:

  • key_file — a pointer to the econf_file structure where the key/value pair should be modified. this is your main character, the file structure itself. 👑
  • group — the name of the configuration group (section) to which the key belongs. remember: NULL or empty string = global section. 🍓
  • key — the name of the key to set. it's the name. of the key. iconic brevity honestly. 🔥
  • value — a pointer to the econf_ext_value structure containing additional information. that metadata-rich queen from earlier. 💜

⭐ RETURN VALUE ⭐

on success, econf_setExtValue() returns ECONF_SUCCESS. we love a clean success. 💖

on error, a non-zero error number is returned. and not just any number — the function returns a value from the econf_err enumeration. so you can go look that up and figure out what went wrong. slay, diagnostics. 😭

💀 ERRORS 💀

  • ECONF_NOMEM — memory allocation failed. she tried her best and the memory said no. allocation flopped, not her fault, but you gotta handle it. 🙈

👑 SEE ALSO 👑

go read those too bestie, iykyk. 📚✨

and that's the whole page, no notes. this one's dated 2025-01-01 and comes to you from libeconf — thank you for coming to my unix talk, mwah, go set some extended values responsibly 💅🎀🦋

📦 where this page comes from