FreeBSD manual
download PDF document: zip_source_win32a_create.3.pdf
ZIP_SOURCE_WIN32A(3) FreeBSD Library Functions Manual ZIP_SOURCE_WIN32A(3)
NAME
zip_source_win32a, zip_source_win32a_create - create data source from a
Windows ANSI file name
LIBRARY
libzip (-lzip)
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);
DESCRIPTION
The functions zip_source_win32a() and zip_source_win32a_create() create a
zip source on Windows using a Windows ANSI name. They open fname and
read len bytes from offset start from it. If len is 0 or -1, the whole
file (starting from start) is used.
If the file supports seek, the source can be used to open a zip archive
from.
The file is opened and read when the data from the source is used,
usually by zip_close() or zip_open_from_source().
RETURN VALUES
Upon successful completion, the created source is returned. Otherwise,
NULL is returned and the error code in archive or error is set to
indicate the error.
ERRORS
zip_source_win32a() and zip_source_win32a_create() fail if:
[ZIP_ER_INVAL] fname, start, or len are invalid.
[ZIP_ER_MEMORY] Required memory could not be allocated.
[ZIP_ER_OPEN] Opening fname failed.
SEE ALSO
libzip(3), zip_file_add(3), zip_file_replace(3), zip_source(3),
zip_source_win32handle(3), zip_source_win32w(3)
HISTORY
zip_source_win32a() and zip_source_win32a_create() were added in libzip
1.0.
AUTHORS
Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>
FreeBSD 14.0-RELEASE-p11 December 18, 2017 FreeBSD 14.0-RELEASE-p11