zip_source_window_create
NAME
zip_source_window_create
—
create zip data source overlay
LIBRARY
libzip (-lzip)SYNOPSIS
#include <zip.h>
zip_source_t *
zip_source_window_create
(zip_source_t
*source, zip_uint64_t
start, zip_int64_t
len, zip_error_t
*error);
DESCRIPTION
Thezip_source_window_create
() function create a zip
source from an underlying zip source, restricting access to a particular
window starting at byte start and having size
len. If len is -1, the window
spans to the end of the underlying source.
zip_source_window
() and
zip_source_window_create
() don't take ownership of
source. The caller is responsible for freeing it.
(This is different to other layered sources.)
RETURN VALUES
Upon successful completion, the created source is returned. Otherwise,NULL
is returned and the error code in
error is set to indicate the error.
ERRORS
zip_source_window_create
() fails if:
- [
ZIP_ER_INVAL
] - src is
NULL
; there is an integer overflow adding start and len; or len is less than -1. - [
ZIP_ER_MEMORY
] - Required memory could not be allocated.
SEE ALSO
libzip(3), zip_source(3)HISTORY
zip_source_window_create
() was added in libzip 1.8.0.