UTHASH-DEV(3)

💖 UTHASH-DEV(3) — the uthash-dev user manual, but make it cute 💖

okay bestie, pull up a chair, we're talking about uthash-dev, the Debian package that's literally a whole friend group of C headers 🫶

✨ NAME ✨

uthash-dev — hash map and linked list implementation 🗺️🔗

🌸 SYNOPSIS 🌸

#include <uthash.h>

#include <utlist.h>

#include <utarray.h>

#include <utstring.h>

#include <utvector.h>

that's it. five includes. five little doorways into data-structure heaven. no cap 💅

🦋 DESCRIPTION 🦋

so the uthash-dev Debian package is built from the uthash source package, and it ships the uthash, utlist, utarray, utstring and utvector headers. all five of them. the whole squad 👑

they can be included in any C source code, and they hand you hash map, linked list, etc. implementations — all as C preprocessor macros. not a library you link against (well, mostly, we'll get to the exception 👀), just macros doing main character work at compile time.

the documentation lives in the documentation directory of the package, at /usr/share/doc/uthash-dev/, in HTML format ✨ and there are also some examples bundled in there, which were provided as test cases in the upstream release. so you can peek at real working code, which is iconic honestly.

🎀 FILES 🎀

• /usr/include/uthash.h — the hash map implementation, as a C preprocessor macro. the namesake. the moment. 💖
• /usr/include/utlist.h — the linked list implementation, as a C preprocessor macro. 🔗
• /usr/include/utarray.h — the dynamic array implementation, as a C preprocessor macro. 📦
• /usr/include/utstring.h — the dynamic string implementation, as a C preprocessor macro. 🧵
• /usr/include/utvector.h — the vector implementation, which maintains a contiguous buffer of 'n' elements. in order to use it, link with -lut. 🧚

⚠️ bestie listen — utvector is the one that actually needs a linker flag. everyone else is header-only macro magic, but this one wants -lut and it's not gonna work without it. don't be the person who forgets. 🙈

💜 AUTHOR 💜

Bastian Blywis <blywis@googlemail.com> — wrote this manpage for the Debian system. thank you king, your service was noted 🫡

🌈 COPYRIGHT 🌈

Copyright © 2009 Bastian Blywis Copyright © 2015 Ilias Tsitsimpis

this manual page was written for the Debian system (and may be used by others).

permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation.

on Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. go read it if you want, it's giving ✨ legally binding ✨ 💀

and that's the whole page, bestie!! this was uthash-dev, dated 06/23/2015, from the uthash-dev User Manual — UTHASH-DEV(3), periodt. now go #include something and slay 💅🌈🦋