ZIP_CLOSE(3)

💖 zip_close — bestie, we're closing the archive 💖

okay so real talk, this one's from the Library Functions Manual, it's ZIP_CLOSE(3), and it's literally the moment of truth where you save everything you did. let's get into it 🎀

---

✨ NAME ✨

zip_close — close zip archive 💅

📚 LIBRARY 📚

libzip (-lzip) — yeah you gotta link the lib, no cap 🫶

🌸 SYNOPSIS 🌸

#include <zip.h>

int
zip_close(zip_t *archive);

🦋 DESCRIPTION 🦋

so the zip_close() function writes any changes made to archive to disk. that's the whole vibe. it's the "okay bestie time to commit" moment ✨

if archive contains no files, the file is completely removed (like, no empty archive is written, we don't do that here 🙈) — unless the archive flag ZIP_AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE is set. then it stays. iykyk 👑

if it's successful, archive is freed. otherwise archive is left unchanged and must still be freed. so like, don't ghost it, you still have to clean up after yourself 😭

if you wanna close and free a zip archive without saving changes, use zip_discard(3). that's the "never mind, forget I said anything" button 🫣

progress updates for GUIs can be implemented using zip_register_progress_callback_with_state(3). and cancelling the write of an archive during zip_close can be implemented using zip_register_cancel_callback_with_state(3). slay, customisable 💖

---

🔥 RETURN VALUES 🔥

upon successful completion, 0 is returned. otherwise, -1 is returned and the error code in archive is set to indicate the error. it's giving "we tried 💀"

💀 ERRORS 💀

zip_close() will fail if:

• [ZIP_ER_EOF] — unexpected end-of-file found while reading from a file. the file just... ended. mid-thought. rude 😭
• [ZIP_ER_INTERNAL] — the callback function of an added or replaced file returned an error but failed to report which. like bestie, which one?? 🙈
• [ZIP_ER_INVAL] — the path argument is NULL. no path, no service 🚫
• [ZIP_ER_MEMORY] — required memory could not be allocated. brain empty, no thoughts 💀
• [ZIP_ER_NOZIP] — file is not a zip archive. it's giving poser 🎭
• [ZIP_ER_READ] — a file read failed.
• [ZIP_ER_RENAME] — a temporary file could not be renamed to its final name. glow-up denied 💅
• [ZIP_ER_SEEK] — a file seek failed.
• [ZIP_ER_TMPOPEN] — a temporary file could not be created.
• [ZIP_ER_WRITE] — a file write failed.
• [ZIP_ER_ZLIB] — an error occurred while (de)compressing a stream with zlib(3). zlib said no 🧚

additionally, any errors returned by the callback function for added or replaced files will be passed back. so watch out for those, they ride along 🫶

---

👀 SEE ALSO 👀

libzip(3), zip_discard(3), zip_fdopen(3), zip_get_error(3), zip_open(3), zip_register_cancel_callback_with_state(3), zip_register_progress_callback_with_state(3), zip_set_archive_flag(3), zip_strerror(3)

go read those too, they're all part of the cinematic universe 🌈

⭐ HISTORY ⭐

zip_close() was added in libzip 0.6. vintage. iconic. periodt 👑

💜 AUTHORS 💜

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at> — the two masterminds behind all this, absolute legends 🫶

⚠️ CAVEATS ⚠️

please note that all indices, zip_stat(3) information and other data about the archive is invalid after zip_close. like, gone. expired. not valid anymore 😭

when you open the same file again, it will be a completely new zip_t structure. new era, new you, new struct ✨

---

and that's the whole page bestie!! 🌸 this was ZIP_CLOSE(3) from the Debian build, dated January 23, 2023 — mwah, love that for us 💖✨