zip_source_win32w(3)

1ZIP_SOURCE_WIN32W(3)     BSD Library Functions Manual     ZIP_SOURCE_WIN32W(3)
2

NAME

4     zip_source_win32w, zip_source_win32w_create — create data source from a
5     Windows Unicode file name
6

LIBRARY

8     libzip (-lzip)
9

SYNOPSIS

11     #include <zip.h>
12
13     zip_source_t *
14     zip_source_win32w(zip_t *archive, const wchar_t *fname,
15         zip_uint64_t start, zip_int64_t len);
16
17     zip_source_t *
18     zip_source_win32w_create(const wchar_t *fname, zip_uint64_t start,
19         zip_int64_t len, zip_error_t *error);
20

DESCRIPTION

22     The functions zip_source_win32w() and zip_source_win32w_create() create a
23     zip source on Windows using a Windows Unicode name.  They open fname and
24     read len bytes from offset start from it.  For a description of the len
25     argument, see zip_source_file(3).
26
27     If the file supports seek, the source can be used to open a zip archive
28     from.
29
30     The file is opened and read when the data from the source is used, usu‐
31     ally by zip_close() or zip_open_from_source().
32

RETURN VALUES

34     Upon successful completion, the created source is returned.  Otherwise,
35     NULL is returned and the error code in archive or error is set to indi‐
36     cate the error.
37

ERRORS

39     zip_source_win32w() and zip_source_win32w_create() fail if:
40
41     [ZIP_ER_INVAL]     fname, start, or len are invalid.
42
43     [ZIP_ER_MEMORY]    Required memory could not be allocated.
44
45     [ZIP_ER_OPEN]      Opening fname failed.
46

HISTORY

52     zip_source_win32w() was added in libzip 1.0.
53
54     ZIP_LENGTH_TO_END and ZIP_LENGTH_UNCHECKED were added in libzip 1.10.1.
55

AUTHORS

57     Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>
58
59BSD                              June 30, 2023                             BSD