FFI::Pl...gle::XS(3)

📦 version 0.03, in alpine 3.24

💅 FFI::Platypus::Lang::CPP::Demangle::XS

okay so bestie, real talk: the full name is FFI::Platypus::Lang::CPP::Demangle::XS and yes it's a mouthful but it's a legendary mouthful. Also, the manual page for this one lives under the name FFI::Pl...gle::XS(3) because even the manpage header got tired of typing it all out 😭 welcome to the readme, you're gonna love it here ✨

🌸 NAME 🌸

FFI::Platypus::Lang::CPP::Demangle::XS — it demangles C++ symbols using the C++ ABI API. That's the whole job. That's the gig. And it ate. 💅

🎀 VERSION 🎀

version 0.03 — small number, big energy, no cap 🫶

✨ SYNOPSIS ✨

like literally just this:

use FFI::Platypus::Lang::CPP::Demangle::XS;

my $demangled = demangle($c_symbol);

that's it. that's the vibe. iykyk 💖

🦋 DESCRIPTION 🦋

This module provides an interface for demangling C++ symbols. 🔥

Think of it as an alternative to "c++filt" for FFI::Platyus::Lang::CPP — yes, that's spelled exactly like that in the original, and no, I'm not touching it, it's iconic in its own way 🙈

Also important, bestie: Perl 5.8.1 or newer is required. don't be out here with Perl 5.8.0, that's not the move 😭

💜 FUNCTIONS 💜

⭐ demangle

my $demangled = demangle($c_symbol);

Demangle the given symbol. That's the main character move right there 👑

Here's the tea though, and you need to hear it:

  • If the input symbol is not a valid C++ symbol, then it returns "undef". Soft no. Gentle rejection. It's not mad, it's just disappointed 🥲
  • If there is any other error (memory allocation, for example), it will throw an exception. so like, wrap it or handle it, don't let it catch you off guard 💀

🌈 SEE ALSO 🌈

  • FFI::Platypus::Lang::CPP — Documentation and tools for using C++ and FFI / Platypus 🫶
  • FFI::Platypus — Write extensions for Perl without XS or a compiler ✨ literally the whole point, obsessed

👑 AUTHOR 👑

Graham Ollis <plicease@cpan.org> — the icon, the legend, the reason we're all here 💖

This software is copyright (c) 2015 by Graham Ollis. 🎀

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay, honestly 🌸

and that's the page, bestie 🧚💜 this gorgeous little manpage came from perl v5.42.2, dated 2025-06-30, and was rendered as FFI::Pl...gle::XS(3) 🦋 go forth and demangle responsibly 💅✨

📦 where this page comes from