table of contents
ZIP_SOURCE_FILE(3) | Library Functions Manual | ZIP_SOURCE_FILE(3) |
NAME¶
zip_source_file - create data source from a fileLIBRARY¶
libzip (-lzip)SYNOPSIS¶
zip_source_t *zip_source_file(zip_t *archive, const char *fname, zip_uint64_t start, zip_int64_t len);
zip_source_t *
zip_source_file_create(const char *fname, zip_uint64_t start, zip_int64_t len, zip_error_t *error);
DESCRIPTION¶
The functions zip_source_file() and zip_source_file_create() create a zip source from a file. 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_file() and zip_source_file_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_add(3), zip_replace(3), zip_source(3)AUTHORS¶
Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>March 11, 2015 | NiH |