ZIP_SOURCE_WINDOW_CREATE(3)

ZIP_SOURCE_WINDOW_CREATE(3) | Library Functions Manual | ZIP_SOURCE_WINDOW_CREATE(3)

# 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) zip_source(3)

# HISTORY

`zip_source_window_create`() was added in libzip 1.8.0.

# AUTHORS

Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>

April 29, 2021 | NiH