zzip_dirhandle(3)

💖 zzip_dirhandle — get handle 💖

okay bestie, so this is a zziplib function list page, and today's main characters are zzip_dirhandle and zzip_dirfd. their whole job? getting you a handle. that's it. that's the vibe. ✨

---

🌸 SYNOPSIS 🌸

#include <zzip/lib.h>

ZZIP_DIR*
zzip_dirhandle(ZZIP_FILE* fp)

int
zzip_dirfd(ZZIP_DIR* dir)

like. look at them. two little functions. so demure. so mindful. 🎀

---

🦋 DESCRIPTION 🦋

okay so first up, zzip_dirhandle — it literally just returns the fp->dir value. no cap, that's the whole thing. it's giving "I don't overthink, I just return the field." 💅

and here's the tea: if a ZZIP_FILE is contained within a zip-file, that one is gonna be a valid pointer. but otherwise a NULL gets returned, and in that case the ZZIP_FILE wraps a real file. so like… pay attention to which one you got, bestie. 🫶

next, zzip_dirfd — it just returns dir->fd. again, no notes, it's an icon.

and same energy here: if a ZZIP_DIR does point to a zipfile, then the file-descriptor of that zipfile is what you get back. otherwise a NULL is returned, and the ZZIP_DIR wraps a real directory DIR — that's the case if you have dirent on your system. 🌈

⚠️ heads up: NULL here is not a "something went wrong" error, it's a "you're dealing with a real file / real directory instead of a zip" signal. different vibe entirely. 👑

---

💜 AUTHOR 💜

Guido Draheim <guidod@gmx.de>

🍓 COPYRIGHT 🍓

Copyright (c) Guido Draheim, use under copyleft (LGPL,MPL)

---

and that's the whole page, bestie!! this was the zziplib function list, version 0.13.78, zzip_dirhandle(3) — mwah, iconic, go forth and check your pointers. 💖✨🎀