zip_source_win32a_create(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.  If len is 0 or -1, the whole
25     file (starting from start) is used.
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

AUTHORS

56     Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>
57
58BSD                            December 18, 2017                           BSD