plucky (3) zip_source_window_create.3.gz

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

     The zip_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.

AUTHORS

     Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>