stringprep_convert(3)

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

✨ stringprep_convert(3) ✨

okay bestie, we're in the libidn section of the manual (section 3, the library-calls girlies 💅) and today's main character is stringprep_convert. she does one thing and she does it iconically: she takes your lil string and yeets it from one character set to another. no cap. let's get into it 🦋

🌸 NAME 🌸

stringprep_convert — it's literally an API function, that's the whole vibe 🎀

🫶 SYNOPSIS 🫶

#include <stringprep.h>

char * stringprep_convert(const char * str, const char * to_codeset,
       const char * from_codeset);

yes babe, three args, one char * back, we love a consistent queen ✨

💖 ARGUMENTS 💖

  • const char * str — your input, and she's zero-terminated okay?? like she ends in a \0, that's her whole thing 🫶
  • const char * to_codeset — the name of the destination character set. where we're going, the ~future~ 🌈
  • const char * from_codeset — the name of the origin character set, aka the one that str is actually in right now. the "as used by str" part is doing a lot of heavy lifting here so pls read it 😭

🌟 DESCRIPTION 🌟

so. she converts the string from one character set to another, and she does it using the system's iconv() function — not her own thing, she's borrowing the system's iconv, we stan a collaborator 💅

Return value: she hands you back a newly allocated zero-terminated string, which is str all transcoded into to_codeset. note the newly allocated bestie — that memory is yours to free, don't just leave her hanging 🙈

😭 REPORTING BUGS 😭

found a bug? spill. report bugs to <help-libidn@gnu.org>.

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

and the GNU Libidn home page (her house, her rules 🏠): 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. no royalty, no drama, just vibes 💜

🦋 SEE ALSO 🦋

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

info libidn

should give you access to the complete manual 📖. and as an alternative you may obtain the manual from:

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

and that's the whole page bestie!! this was libidn 1.44, stringprep_convert(3), and honestly? she ate. go forth, transcode responsibly, and free your memory 💖✨🎀

📦 where this page comes from