idn2_free(3)

📦
version 2.3.8 · 5 versions
, in alpine 3.23, alpine 3.24, arch rolling, debian trixie, fedora 43, fedora 44, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 idn2_free(3) — the libidn2 girlies' guide 💖

okay bestie, welcome to the libidn2 manual, section 3 (that's the library-functions girlies, not the command-line ones, iykyk). today's episode: idn2_free. it's short. it's sweet. it's giving "one job and she does it." 🎀

✨ NAME ✨

idn2_free — API function 🌸

like. that's it. that's the name. she's an API function and she knows it. 👑

✨ SYNOPSIS ✨

the vibe check, verbatim:

#include <idn2.h>

void idn2_free(void * ptr);

no cap, that's the whole thing. void in, void out, main character energy. 💅

✨ ARGUMENTS ✨

  • void * ptr — pointer to deallocate 🫶

that's the one (1) thing you hand her. it's a pointer. she's gonna deallocate it. periodt.

✨ DESCRIPTION ✨

so what does she actually do? she calls free(3) on the given pointer. that's it. that's the whole plot. 🔥

but here's the lore you actually need, bestie: this function is typically only useful on systems where the library malloc heap is different from the library caller malloc heap. and when does that happen? on Windows, when the library is a separate DLL. 🪟✨

basically: if you and the library are shopping in different malls, you can't just return your stuff at her customer service desk — you gotta go through her. so you call idn2_free, and she takes care of it on the correct heap. it's giving long-distance bestie coordination. 😭💖

✨ REPORTING BUGS ✨

found a bug? don't suffer in silence, bestie, tell the devs!! 🐛

Copyright © 2002-2025 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. (yes queen, redistribute responsibly 💅)

✨ SEE ALSO ✨

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

info libidn2

should give you access to the complete manual. 📖✨

as an alternative you may obtain the manual from:

https://www.gnu.org/software/libidn/libidn2/manual/
🫶 friendly reminder from your local Unix bestie: idn2_free is here for the cross-heap girlies (Windows DLL situations, you know who you are). if that's not your setup, she might lowkey be doing nothing for you — but she's still iconic for existing.

and that's a wrap on libidn2 version 2.3.8, page idn2_free(3) 💖 thanks for coming to my ted talk, go forth and deallocate responsibly, mwah! 🌈🎀🦋

📦 where this page comes from