ZIP_SOURCE_WIN32A(3)

💖 ZIP_SOURCE_WIN32A 💖

okay bestie, so this is the libzip manual for zip_source_win32a and zip_source_win32a_create — the Windows girlies that build a zip source out of a Windows ANSI file name. it's giving "I only speak ANSI, not wide chars, and that's on purpose" 💅

---

✨ LIBRARY ✨

libzip (-lzip) 🎀 — yeah she lives in libzip, link her with -lzip and she's yours.

---

🌸 SYNOPSIS 🌸

#include <zip.h>

zip_source_t *
zip_source_win32a(zip_t *archive, const char *fname, zip_uint64_t start,
    zip_int64_t len);

zip_source_t *
zip_source_win32a_create(const char *fname, zip_uint64_t start,
    zip_int64_t len, zip_error_t *error);

literally just drop that #include <zip.h> in there and you're set 🫶

---

🦋 DESCRIPTION 🦋

so zip_source_win32a() and zip_source_win32a_create() are the twin icons that make a zip source on Windows using a Windows ANSI name. they open fname and read len bytes starting from offset start. periodt ✨

the way that len works? bestie, that's a whole other page — go read zip_source_file(3) for the full tea on that argument. 📖

if the file supports seek, then the source can be used to open a zip archive from. cute, right? 😌

heads up though: the file is not opened and read right away. she's lowkey mysterious — she opens and reads only when the data from the source actually gets used, usually by zip_close() or zip_open_from_source(). so don't come for her if nothing's happened yet 💀

---

👑 RETURN VALUES 👑

upon successful completion, the created source is returned. slay. 🌟

otherwise? NULL comes back and the error code in archive or error is set to indicate the error. not the vibe, but at least she tells you why 😭

---

💜 ERRORS 💜

zip_source_win32a() and zip_source_win32a_create() fail if:

• [ZIP_ER_INVAL] — fname, start, or len are invalid. 🙈 check your inputs bestie
• [ZIP_ER_MEMORY] — required memory could not be allocated. the RAM said no 💀
• [ZIP_ER_OPEN] — opening fname failed. the door was locked fr fr 🚪

---

🌈 SEE ALSO 🌈

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

the whole friend group, go say hi 🫶✨

---

🎀 HISTORY 🎀

zip_source_win32a() and zip_source_win32a_create() were added in libzip 1.0. iconic from the start, no cap 👑

and then ZIP_LENGTH_TO_END and ZIP_LENGTH_UNCHECKED were added in libzip 1.10.1. a glow-up era, honestly 🌸

---

💖 AUTHORS 💖

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at> — the legends, the main characters, the ones who wrote this so you wouldn't have to 🫡💅

---

and that's the whole page bestie!! this beauty came out of the Debian side of things, dated June 30, 2023, and she answers to ZIP_SOURCE_WIN32A(3) in the Library Functions Manual. iykyk 🦋✨💖