oath_bin2hex(3)

✨ oath_bin2hex(3) ✨

okay bestie, welcome to liboath — this little cutie is oath_bin2hex, and it's literally the glow-up your binary data has been waiting for 💅

---

🌸 NAME 🌸

oath_bin2hex — it's an API function, no cap, and it's here to serve 🫶

---

🎀 SYNOPSIS 🎀

#include <oath.h>

void oath_bin2hex(const char * binstr, size_t binlen, char * hexstr);

like, that's the whole vibe. short, iconic, to the point 👑

---

🦋 ARGUMENTS 🦋

• const char * binstr — the input binary data. your raw, unedited self. we love her 🙈
• size_t binlen — the length of that input binary data binstr. you gotta tell her how much she's working with, fr fr
• char * hexstr — the output string with hex data. ⚠️ and listen — she must have room for 2*binlen+1. not 2*binlen, not "eh, close enough." 2*binlen+1. the +1 is the NUL, she's important 💀

---

💖 DESCRIPTION 💖

So what does she actually do? She converts binary data into a NUL-terminated string with hex data. that's it, that's the whole job, and she does it flawlessly ✨

the output hexstr is allocated by the caller — that's you, bestie, you're the main character here — and it must have room for at least 2*binlen+1. why? because you need space for the encoded data and the terminating NUL byte. the math is mathing, the vibes are immaculate 💅

no cap: if you skimp on that buffer size, that's on you. the +1 is not decorative, she's load-bearing 😭

---

🌈 SINCE 🌈

1.12.0 — she's been around a minute. vintage, but make it fresh 🎀

---

🐛 REPORTING BUGS 🐛

Found a bug? don't suffer in silence, bestie — report it to oath-toolkit-help@nongnu.org 📧

• liboath home page: https://oath-toolkit.codeberg.page/
• general help using GNU software: http://www.gnu.org/gethelp/

---

👑 COPYRIGHT 👑

Copyright © 2009-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. slay, honestly — free to share, just keep the receipts 🫶

---

🌸 ꒰ঌ sign-off ໒꒱ 🌸

that was oath_bin2hex(3) from liboath, version 2.6.15 — go forth and hex-encode responsibly, bestie. you're gonna ate this 💜✨

⭐⭐⭐