idn_setlanguage(3)

✨ NAME ✨

Okay bestie, this is idn_setlanguage(3) from the Library Functions Manual — the function that sets "the current language". It's literally the language-setting main character of idnkit. 💅

🛠️ SYNOPSIS 🛠️

#include <idn/api.h>

idn_result_t
idn_setlanguage(const char *name);

💖 DESCRIPTION 💖

So idn_setlanguage() sets "the current language" to name. That current language value is not just decorative — it affects the results of the "language-local" and "lowercase" mapping procedures in encoding and decoding conversions. iykyk ✨

If the name argument is NULL, the current language is determined by locale information. For example, if the locale category LC_CTYPE has been set to "ja_JP.UTF-8", the idnkit library supposes the current language is "ja" (Japanese). And if an application changes its locale setting, the current language value is changed automatically too. 🦋

⚠️ But here's the plot twist, bestie: once a non-NULL language name has been set by idn_setlanguage() or set by the "language" entry in a configuration file, the current language will not be changed by locale information any longer. Periodt. 💀

Upon success, idn_setlanguage() returns idn_success. Otherwise, it returns an error code. See idn_result_tostring(3) for the complete list of error codes. 🫶

👀 SEE ALSO 👀

libidnkit(3), idn_checkname(3), idn_comparenames(3), idn_decodename(3), idn_encodename(3), idn_nameinit(3), idn_result_tostring(3), idn.conf(5), idnlang.conf(5)

Source/version: Library Functions Manual; date: Sep 21, 2012; page: idn_setlanguage(3). Bye bestie, slay your language settings! 💖✨