zip_source_win32a(3)

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

NAME

4     zip_source_win32a, zip_source_win32a_create — create data source from a
5     Windows ANSI file name
6

LIBRARY

8     libzip (-lzip)
9

SYNOPSIS

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

DESCRIPTION

22     The functions zip_source_win32a() and zip_source_win32a_create() create a
23     zip source on Windows using a Windows ANSI 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_win32a() and zip_source_win32a_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_win32a() and zip_source_win32a_create() were added in libzip
53     1.0.
54
55     ZIP_LENGTH_TO_END and ZIP_LENGTH_UNCHECKED were added in libzip 1.10.1.
56

AUTHORS

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