LIBXO(3)

📦
version 1.7.5 · 2 versions
, in epel 9, fedora 43, fedora 44, nixpkgs unstable

💖 LIBXO(3) — the manual, but make it slay 💖

okay bestie, welcome to the LIBXO(3) page, from the Library Functions Manual. this one's short and sweet and it's literally just one little function, but she's important, so let's get into it 🫶

✨ NAME ✨

xo_no_setlocale — prevent implicit call to setlocale

like. the whole job. that's her. 💅

📚 LIBRARY 📚

library "libxo" — that's the one you're linking against, no cap.

🌸 SYNOPSIS 🌸

#include <libxo/xo.h>

void
xo_no_setlocale(void);

that's it. that's the whole vibe. one include, one function, zero arguments, returns nothing. iconic behavior honestly 💜

🦋 DESCRIPTION 🦋

okay so here's the tea ☕. libxo auto-initializes the locale for you, based on whatever's set in the environment variables LC_CTYPE, LANG, and LC_ALL.

the way it works: it takes the first one of those three in that list that's set, and uses that. and if none of the variables are set, the locale just defaults to UTF-8. comfy, right? 🌈

but sometimes you — the caller — are like "no thank you, I got this myself" 🙅 and you want to avoid that whole behavior. that's when you call xo_no_setlocale(). she's the "please don't touch my locale" button. periodt. 💅

👀 SEE ALSO 👀

go read those too, bestie, they're the friend group 🫶

📜 HISTORY 📜

the libxo library first appeared in FreeBSD 11.0. a legend was born ✨

💖 AUTHORS 💖

libxo was written by Phil Shafer <phil@freebsd.org> — thank you king, we owe you everything 👑

📖 ADDITIONAL DOCUMENTATION 📖

FreeBSD uses libxo version 1.7.5. if you want the complete documentation (and who doesn't, honestly), it's on github:

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

libxo lives on github as:

https://github.com/Juniper/libxo

and the latest release of libxo is available at:

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

go, read, be obsessed 📚💜

🕰️ HISTORY 🕰️

(yeah there's a second one, the manpage said it twice and I'm not gonna gatekeep 🙈)

the libxo library was added in FreeBSD 11.0. same era, same legend.

🫶 AUTHOR 🫶

Phil Shafer

and that's the whole page, bestie!! this one came from the Debian crew, dated December 4, 2014, and it's filed under LIBXO(3). go forth and don't let anyone set your locale without asking first 💅✨🎀🦋

📦 where this page comes from