ZIP_SOURCE_SEEK(3)

✨ ZIP_SOURCE_SEEK ✨ (that's the zip_source_seek page from the Library Functions Manual, bestie 💖)

okay so real talk — this is a page from the Library Functions Manual and it's all about zip_source_seek, a lil function from libzip that lets you slide the read cursor around inside a zip source. it's giving "scrub to wherever you want in the file" energy. let's go 🦋

---

💫 NAME 💫

zip_source_seek — set read offset in zip source

---

📚 LIBRARY 📚

libzip (-lzip)

(yeah girl, you gotta link against it, no cap 🫶)

---

🌸 SYNOPSIS 🌸

#include <zip.h>

int
zip_source_seek(zip_source_t *source, zip_int64_t offset, int whence);

look at that signature. three args, one int back. iconic. 💅

---

👑 DESCRIPTION 👑

zip_source_seek() sets the current read offset for source. that's it, that's the whole job. it's the "where am i reading from now" setter.

and just like in fseek(3) (yes bestie, the classic), where you land depends on the whence argument — the offset gets counted relative from:

• SEEK_SET — start of file 🌅
• SEEK_CUR — current read offset in file 📍
• SEEK_END — end of file 🏁

so like, SEEK_SET is "from the very beginning, main character origin story", SEEK_CUR is "from wherever i'm standing right now", and SEEK_END is "from the back, counting backwards". pick your vibe, the offset does the rest. ✨

---

🔥 RETURN VALUES 🔥

upon successful completion, 0 is returned. slay.

otherwise, -1 comes back and the error information in source is set to indicate the error. so if you get a -1, check source for the tea — it'll tell you what went wrong. 😭

---

🫶 SEE ALSO 🫶

• libzip(3)
• zip_source(5)
• zip_source_is_seekable(3)
• zip_source_read(3)
• zip_source_tell(3)

(go read zip_source_is_seekable(3) first if you're not sure your source even can seek, iykyk 🌈)

---

🎀 HISTORY 🎀

zip_source_seek() was added in libzip 1.0. so it's been here since the beginning, a true OG. 👑

---

💜 AUTHORS 💜

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>

absolute legends, we stan. 🌟

---

and that's the whole page, bestie!! this one came from the Debian build, dated March 10, 2023, page ZIP_SOURCE_SEEK(3) — so if you're citing it or whatever, that's the version you're holding. now go forth and seek responsibly 🧚💖✨