ASN1_UNIVERSALSTRING_TO_STRING(3ssl)

📦 version 4.1.0, in opensuse-leap 16.0

💅 ASN1_UNIVERSALSTRING_TO_STRING(3ssl) 💅

okay bestie, so this is the ASN1_UNIVERSALSTRING_TO_STRING page from the 3ssl manual — yes it's a mouthful, we're gonna get through it together 🫶

✨ NAME ✨

ASN1_UNIVERSALSTRING_to_string — recode UTF-32 to ISO Latin-1, in place, no big deal 💅

🎀 SYNOPSIS 🎀

#include <openssl/asn1.h>

int
ASN1_UNIVERSALSTRING_to_string(ASN1_UNIVERSALSTRING *string);

like, that's it. one include, one function, one pointer. we love a minimal era 💖

🦋 DESCRIPTION 🦋

okay so here's the tea 🍓 ASN1_UNIVERSALSTRING_to_string() assumes the string you hand it is encoded in UTF-32, then recodes it in place to ISO Latin-1, and changes the type according to ASN1_PRINTABLE_type(3). literally the glow-up happens on your own string, no new allocation, main character energy ✨

🙈 and babes, watch out: it assumes. it does not ask. it does not vibe check. it just goes.

and when does it flop? ASN1_UNIVERSALSTRING_to_string() fails and leaves the string unchanged if:

  • its ASN1_STRING_type(3) is not V_ASN1_UNIVERSALSTRING — wrong type, wrong party, not invited 💀
  • its ASN1_STRING_length(3) is not a multiple of four bytes — math is not mathing 😭
  • any of its characters cannot be represented in ISO Latin-1 — some glyphs simply refuse to be contained, and that's valid 🌈

in case of success, the ASN1_STRING_length(3) of the string is reduced by a factor of four. yeah bestie, it shrinks to a quarter of its size — UTF-32 was doing the absolute most with those bytes and Latin-1 said "let's be efficient" 🔥

👑 RETURN VALUES 👑

  • 1 — success, we ate 💅
  • 0 — failure, it's giving flop, but the string is untouched so no harm done 🫶

🌸 SEE ALSO 🌸

iykyk, go read those next 📚

⭐ HISTORY ⭐

ASN1_UNIVERSALSTRING_to_string() first appeared in SSLeay 0.8.0 and has been available since OpenBSD 2.4. an icon, a legend, a veteran of the encoding wars 👑

and that's the whole thing bestie, no notes 💜 big shoutout to Debian and the date stamp reading November 15, 20 — stay encoded, stay iconic, mwah 🎀💖✨

📦 where this page comes from