LIBXO(3)

✨ LIBXO(3) ✨

okay bestie, buckle up 💖 this is the manual page for libxo — Library Functions Manual — and it's literally the glow-up your command-line tool's output has been waiting for. We're talking xo_parse_args, xo_set_program, the whole vibe. iykyk. 🦋

---

🌸 NAME 🌸

xo_parse_args, xo_set_program — detect, parse, and remove arguments for libxo 💅

📚 LIBRARY 📚

library “libxo” — yeah that's the one, she's the moment 👑

✨ SYNOPSIS ✨

#include <libxo/xo.h>

int
xo_parse_args(int argc, char **argv);

int
xo_set_program(const char *name);

💜 DESCRIPTION 💜

okay so first up: the xo_parse_args() function is the one that handles your command-line arguments — and those are all documented over in xo_options(7), go peek. 👀

Here's the tea: the libxo-specific options get processed and removed from the argument list so that your calling application does not need to deal with them at all. like, they're handled, bye, not your problem anymore 🫶. If everything goes well, you get a new value for argc back. If it goes badly? a message gets emitted and -1 is returned. 😭

          argc = xo_parse_args(argc, argv);
          if (argc < 0)
              exit(EXIT_FAILURE);

and once you've called xo_parse_args(), your application can just carry on processing whatever arguments are left, totally normal, no drama ✨

now, the xo_set_program() function — this one sets the name of the program as it gets reported by functions like xo_failure(), xo_warn(), xo_err(), etc. 📣 The program name gets initialized by xo_parse_args(), but if you call xo_set_program() later you can override that value. main character energy, honestly.

⚠️ important bestie: the value is not copied! so the memory you pass to xo_set_program() (and xo_parse_args()) must be maintained by the caller. do not let that memory ghost you, fr fr 💀

🔗 SEE ALSO 🔗

• xo_emit(3)
• xo_options(7,)
• libxo(3)

📜 HISTORY 📜

The libxo library first appeared in FreeBSD 11.0. iconic behavior 🌈

👑 AUTHORS 👑

libxo was written by Phil Shafer <phil@freebsd.org>. slay 💅

📖 ADDITIONAL DOCUMENTATION 📖

FreeBSD uses libxo version 1.7.5. Complete documentation can be found on github:

      https://juniper.github.io/libxo/1.7.5/html/index.html

libxo lives on github as:

      https://github.com/Juniper/libxo

The latest release of libxo is available at:

      https://github.com/Juniper/libxo/releases

📜 HISTORY 📜

The libxo library was added in FreeBSD 11.0. (yes, we said it twice, it's that important bestie 🎀)

✍️ AUTHOR ✍️

Phil Shafer

---

and that's the whole page, no cap 💜 this beauty came out of Debian, dated November 17, 2020, and it's page LIBXO(3) of the manual — go forth and format your output gorgeously, bestie 🦋✨💖