ZIP_SOURCE_WIN32W(3)

✨ zip_source_win32w, zip_source_win32w_create ✨

okay bestie, so this page is about zip_source_win32w() and zip_source_win32w_create() — two lil cuties that build you a data source out of a Windows Unicode file name 💖. That's the whole vibe. Sit down, sip ur drink, we're doing this.

---

🎀 LIBRARY 🎀

libzip — link it with -lzip and ur good to go, no cap.

---

✨ SYNOPSIS ✨

#include <zip.h>

zip_source_t *
zip_source_win32w(zip_t *archive, const wchar_t *fname,
    zip_uint64_t start, zip_int64_t len);

zip_source_t *
zip_source_win32w_create(const wchar_t *fname, zip_uint64_t start,
    zip_int64_t len, zip_error_t *error);

---

💅 DESCRIPTION 💅

So. Both zip_source_win32w() and zip_source_win32w_create() make a zip source, but like, on Windows, using a Windows Unicode name 🌸. They open fname and read len bytes starting from offset start. That's it, that's the whole job.

For the tea on how len actually behaves, go read zip_source_file(3) — it explains it, and honestly it explains it better than I could in a group chat message 🫶.

If the file supports seek, then the source can be used to open a zip archive from. Iconic.

Now here's the part u need to internalise: the file is opened and read when the data from the source is used, usually by zip_close() or zip_open_from_source(). Not before. Not at creation. When it's used. The way it just waits patiently… main character energy, honestly 😌.

---

🦋 RETURN VALUES 🦋

Slay → u get the created source back. 💖

Not slay → u get NULL, and the error code in archive or error is set to tell u what went wrong. Read it, bestie, it's literally right there.

---

💀 ERRORS 💀

zip_source_win32w() and zip_source_win32w_create() fail if:

• [ZIP_ER_INVAL] — fname, start, or len are invalid. 🚩
• [ZIP_ER_MEMORY] — required memory could not be allocated. the audacity 😭
• [ZIP_ER_OPEN] — opening fname failed. 🙈

---

🔥 SEE ALSO 🔥

• libzip(3)
• zip_file_add(3)
• zip_file_replace(3)
• zip_source(5)
• zip_source_file(3)
• zip_source_win32a(3)
• zip_source_win32handle(3)

like a whole friend group fr fr, go say hi 👑

---

🌈 HISTORY 🌈

• zip_source_win32w() was added in libzip 1.0. vintage ✨
• ZIP_LENGTH_TO_END and ZIP_LENGTH_UNCHECKED were added in libzip 1.10.1. newer, shinier, obsessed 💅

---

👑 AUTHORS 👑

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at> — the legends themselves, we stan 🫶

---

ok that's the whole page bestie, u understood all of it, i'm so proud. now go read zip_source_file(3) like i told u 😭💖

Debian 🌸 June 30, 2023 🦋 ZIP_SOURCE_WIN32W(3) — mwah, that's a wrap, periodt ✨💅