ZIP_SOURCE_ZIP(3)

💖 zip_source_zip — the NAME moment 💖

okay bestie, gather round, because this page is literally called zip_source_zip, zip_source_zip_create and what it does is create a data source from a zip file — and yes, it's the obsolete interface, we'll get to that, don't panic 🫶

---

📚 LIBRARY 📚

libzip (-lzip) — that's the one, that's the girl 💅

---

✨ SYNOPSIS ✨

#include <zip.h>

zip_source_t *
zip_source_zip(zip_t *archive, zip_t *srcarchive, zip_uint64_t srcidx,
    zip_flags_t flags, zip_uint64_t start, zip_int64_t len);

zip_source_t *
zip_source_zip_create(zip_t *srcarchive, zip_uint64_t srcidx,
    zip_flags_t flags, zip_uint64_t start, zip_int64_t len,
    zip_error_t *error);

like look at those signatures, they ate 🔥

---

🦋 DESCRIPTION 🦋

so. real talk. zip_source_zip() and zip_source_zip_create() are the obsolete versions of zip_source_zip_file(3) and zip_source_zip_file_create(3) respectively. old queens, still iconic, but the newer ones are the main characters now. 😭

if what you actually want is the compressed data of the complete file, you do this instead:

zip_source_zip_file(za, source_archive, source_index,
ZIP_FL_COMPRESSED, 0, -1, NULL)

periodt. write that down.

now, what do the old ones actually do? They create a zip source from a file inside a zip archive. So:

• srcarchive is the (open!) zip archive that's holding the source zip file, and that file lives at index srcidx — got it? index, not name, bestie.
• len bytes starting from offset start get used in the zip_source.
• if len is 0 or -1, then it's the rest of the file, starting from start. simple as.
• and if start is zero and len is -1, the whole file gets copied without decompressing it. no decompression, just vibes. 💅

the flags that are supported (just the one, she's lowkey solo):

• ZIP_FL_UNCHANGED — try to get the original data, without any of the changes that may have been made to srcarchive after it was opened. like, pre-edit footage. no cap.

---

🎀 RETURN VALUES 🎀

if it works? the created source is returned. slay. 🎉

if it doesn't? NULL comes back, and the error code in archive or error is set to tell you what went wrong. it's giving "we need to talk". 💀

---

💀 ERRORS 💀

zip_source_zip() and zip_source_zip_create() fail if:

• [ZIP_ER_CHANGED] — you asked for unchanged data, but it's just not available. she's not there, babe. 🙈
• [ZIP_ER_INVAL] — srcarchive, srcidx, start, or len are invalid. check ur args bestie.
• [ZIP_ER_MEMORY] — the memory it needed could not be allocated. 😭

and additionally, it can return all error codes from zip_stat_index() and zip_fopen_index(). so many possibilities, she contains multitudes ✨

---

👑 SEE ALSO 👑

libzip(3), zip_file_add(3), zip_file_replace(3), zip_source(5)

go read them, iykyk 🌈

---

🌸 HISTORY 🌸

• zip_source_zip() was added in libzip 1.0.
• zip_source_zip_create() was added in libzip 1.8.0.
• Both were deprecated in libzip 1.10.0. 💀 rip boo, you had a good run.
• Use zip_source_zip_file() or zip_source_zip_file_create() instead. that's the assignment. 🫶

---

💜 AUTHORS 💜

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at> — the parents of this whole thing, obsessed with them 💖

---

and that's the page!! this was the Debian build of the zip_source_zip(3) manual, dated January 23, 2023 — mwah, thanks for reading, love u, bye bestie!! 💅✨🎀🦋🌸