stringprep_locale_to_utf8(3)

📦
version 1.44 · 5 versions
, in arch rolling, epel 10, fedora 43, fedora 44, ubuntu stonking

✨ stringprep_locale_to_utf8 — the glow-up your strings deserve ✨

okay bestie, welcome to libidn's little conversion station 💖 this is the <stringprep.h> girlie that takes your string out of whatever dusty locale charset it's been living in and gives it the full UTF-8 makeover. she's an API function, she's iconic, she's literally here to help.

🌸 SYNOPSIS 🌸

#include <stringprep.h>

char * stringprep_locale_to_utf8(const char * str);

🎀 ARGUMENTS 🎀

  • const char * str — the input string, zero terminated, no cap. that's the thing you're sending to the salon 💅

🦋 DESCRIPTION 🦋

so the way this works is: she converts a string that's encoded in the locale's character set into UTF-8, and she does it by using stringprep_convert(). that's the whole vibe. no extra steps, no drama, just the conversion ✨

Return value: she hands you back a newly allocated zero-terminated string — that's your str, transcoded into UTF-8. brand new memory, freshly allocated, main character energy 👑

heads up bestie: newly allocated means somebody (you 💀) has to free it eventually. she's not doing that part for you.

😭 REPORTING BUGS 😭

found something cursed? report bugs to <help-libidn@gnu.org> 🫶

the general guidelines for reporting bugs live at: https://www.gnu.org/gethelp/

and the GNU Libidn home page is right here: https://www.gnu.org/software/libidn/

Copyright © 2002-2026 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

(that's fr fr the whole license situation — no royalty, just keep the notice 🌈)

🌟 SEE ALSO 🌟

the full documentation for libidn is maintained as a Texinfo manual. if the info and libidn programs are properly installed at your site, the command

info libidn

should give you access to the complete manual. obsessed with that for you 📖✨

as an alternative you may obtain the manual from:

https://www.gnu.org/software/libidn/manual/

and that's the whole page, bestie 🩷 this one's from libidn, version 1.44 — go convert something pretty. periodt. 💅🎀🦋

📦 where this page comes from