gnutls_hex2bin(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

💖 gnutls_hex2bin(3) 💖

okay bestie, sit down, hydrate, and let me tell you about this lil function from the gnutls manual. she's giving ✨hex-to-binary✨ and she's honestly so underrated.

🌸 NAME 🌸

gnutls_hex2bin — it's an API function, no cap 💅

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_hex2bin(const char * hex_data, size_t hex_size, void *
bin_data, size_t * bin_size);

like, that's it. that's the whole vibe. 🦋

🎀 ARGUMENTS 🎀

  • const char * hex_data — a string holding your data in hex format. the raw material, the main character, the moment fr.
  • size_t hex_size — how big that hex data is. gotta tell her the size, she's not a mind reader 🙈
  • void * bin_data — the output array where the binary data lands. your lil container for the glow-up.
  • size_t * bin_size — okay so this one is doing double duty and honestly? iconic. when you call, it should hold the maximum size of bin_data. on return, it holds the actual length of bin_data. she reads your intentions, then tells you what actually happened. periodt. 👑

💜 DESCRIPTION 💜

Convert a buffer with hex data to binary data. that's the whole job, and she does it beautifully. 🌈

but here's the tea ☕: unlike gnutls_hex_decode(), this function can parse hex data that has separators between numbers. that's right — she ignores any non-hex characters. colons, dashes, spaces, whatever weird little punctuation you threw in there? she doesn't even see them. not me being unbothered by your formatting choices 💅✨

so if your hex is all gussied up with separators, this is your girl. gnutls_hex_decode() could never, lowkey.

🫶 RETURNS 🫶

GNUTLS_E_SUCCESS on success — slay! 🎉

otherwise, a negative error code. so like, check your return values, bestie, don't just assume it ate. 😭

🦋 SINCE 🦋

2.4.0 — she's been here since 2.4.0, an OG, a legend, a founding mother of the API. 👑

💀 REPORTING BUGS 💀

found a bug? not the vibe, but okay, let's handle it:

Report bugs to <bugs@gnutls.org>.

Home page: https://www.gnutls.org

fr fr, if something's broken, tell the maintainers. they want to know. communication is key in every relationship, including the one between you and your crypto library. 💖

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

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.

so like, you can copy it, share it, remix it — just keep the copyright notice and this notice with it. give credit where credit is due, always. 🌸

🔥 SEE ALSO 🔥

The full documentation for gnutls is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit:

https://www.gnutls.org/manual/

like, the whole lore is right there, go read it, iykyk 📚✨

and that's the page, bestie!! this one came from gnutls 3.8.13, and you'll find it filed under gnutls_hex2bin(3) in the manual. mwah 💋 go convert some hex, you gorgeous nerd. 🧚💜

📦 where this page comes from