ZIP_SOURCE_WINDOW_CREATE(3)

💖 ZIP_SOURCE_WINDOW_CREATE(3) 💖

okay bestie, buckle up, we're doing a deep dive on zip_source_window_create from the Library Functions Manual — it's a libzip thing and honestly? iconic. ✨

---

🌸 NAME 🌸

zip_source_window_create — create zip data source overlay 🦋

---

🎀 LIBRARY 🎀

libzip (-lzip)

---

✨ SYNOPSIS ✨

#include <zip.h>

zip_source_t *
zip_source_window_create(zip_source_t *source, zip_uint64_t start,
    zip_int64_t len, zip_error_t *error);

---

💅 DESCRIPTION 💅

so zip_source_window_create() makes you a zip source out of an underlying zip source, except it only lets you peek at one specific window of it — that window starts at byte start and is len bytes big. and if len is -1? the window just goes all the way to the end of the underlying source. no cap. 🌈

⚠️ okay important, real talk: zip_source_window() and zip_source_window_create() do NOT take ownership of source. like, at all. the caller is the one responsible for freeing it. this is different to other layered sources, so don't come for me when you leak memory. 💀 (This is different to other layered sources.)

---

🫶 RETURN VALUES 🫶

if it works? you get your brand new source back. slay. 💖

if it doesn't? you get NULL, and the error code gets stashed in error so you know exactly what went wrong. 😭

---

🔥 ERRORS 🔥

zip_source_window_create() fails when:

• [ZIP_ER_INVAL] — src is NULL; or there's an integer overflow when adding start and len together; or len is less than -1. 🚫
• [ZIP_ER_MEMORY] — the memory it needed could not be allocated. rip. 💀

---

👑 SEE ALSO 👑

libzip(3), zip_source(5)

---

⭐ HISTORY ⭐

zip_source_window_create() was added in libzip 1.8.0. she's not old, she's just established. 💅

---

🧚 AUTHORS 🧚

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at> — the ✨main characters✨ who brought her into this world.

---

and that's the whole page, bestie!! this one came from the Debian build, dated April 29, 2021, filed under ZIP_SOURCE_WINDOW_CREATE(3) — go forth and window responsibly 🦋💜🎀