stringprep_profile(3)

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

💖 stringprep_profile — the libidn glow-up function 💖

okay bestie, welcome to libidn's stringprep_profile(3). this is the manual page, but make it make sense. 🫶

✨ NAME ✨

stringprep_profile — the API function that gives your UTF-8 string a whole makeover. 💅

🌸 SYNOPSIS 🌸

#include <stringprep.h>

int stringprep_profile(const char * in, char ** out, const char *
profile, Stringprep_profile_flags flags);

🎀 ARGUMENTS 🎀

  • const char * in — the input array holding the UTF-8 string you want prepped. it's giving "before" pic. 🙈
  • char ** out — the output variable, and it's a pointer to a newly allocated string. main character energy fr fr. ✨
  • const char * profile — the name of the stringprep profile you wanna use. pick your fighter. 👑
  • Stringprep_profile_flags flags — a Stringprep_profile_flags value, or 0. (yes, 0 is always an option, love that for us.) 💀

🦋 DESCRIPTION 🦋

so here's the vibe: you feed it the input zero terminated UTF-8 string, it preps that string according to the stringprep profile, and it hands the result back to you in a newly allocated variable. glow-up complete. 🌈

ngl, there's a catch: if your strings came in through the system's locale, you must convert them into UTF-8 before you call this function. how? peep stringprep_locale_to_utf8(). iykyk. 😌

also, the out variable? yeah, the caller has to deallocate that. it's yours now, bestie — clean up after yourself. 🧹

the flags are one of the Stringprep_profile_flags values, or 0. no cap.

and the profile specifies the name of the stringprep profile you're using. it must be one of the internally supported stringprep profiles — no custom ones, no improvising, periodt. 💅

Return value: returns STRINGPREP_OK iff successful — or an error code if it's not. that's the whole mood. 🔥

😭 REPORTING BUGS 😭

found a bug? first of all, same. second of all, report it to <help-libidn@gnu.org>. 🫶

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. (iconic of them honestly ✨)

👑 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, this command:

info libidn

should give you access to the complete manual. very slay. 💖

as an alternative, you can grab the manual from:

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

that's the whole page, bestie — libidn version 1.44, stringprep_profile(3), and yes this manual page is officially done. go prep those strings. 🦋💅✨

📦 where this page comes from