| ZIP_NAME_LOCATE(3) | Library Functions Manual | ZIP_NAME_LOCATE(3) |
zip_name_locate —
get index of file by name
libzip (-lzip)
#include
<zip.h>
zip_int64_t
zip_name_locate(zip_t
*archive, const char
*fname, zip_flags_t
flags);
The
zip_name_locate()
function returns the index of the file named fname in
archive. If archive does not
contain a file with that name, -1 is returned.
If neither ZIP_FL_ENC_RAW nor
ZIP_FL_ENC_STRICT are specified, guess the encoding
of the name in the ZIP archive and convert it to UTF-8, if necessary, before
comparing.
If neither ZIP_FL_ENC_CP437 nor
ZIP_FL_ENC_UTF_8 are specified, guess the encoding
of fname.
Only CP-437 and UTF-8 are recognized.
The flags are specified by or'ing the following values, or 0 for none of them.
ZIP_FL_NOCASEzip_name_locate()
will be slow for archives with many files.ZIP_FL_NODIRzip_name_locate() will be slow for archives with
many files.ZIP_FL_ENC_GUESSZIP_FL_ENC_RAWZIP_FL_ENC_STRICTZIP_FL_ENC_CP437ZIP_FL_ENC_UTF_8Note: ASCII is a subset of both CP-437 and UTF-8.
zip_name_locate() returns the index of the
file named fname or -1, if
archive does not contain an entry of that name.
zip_name_locate() fails if:
ZIP_ER_INVAL]ZIP_ER_MEMORY]ZIP_ER_NOENT]zip_name_locate() was added in libzip 0.6.
In libzip 0.11 the return type was changed from int to
zip_int64_t. In libzip 0.11 the type of
flags was changed from int to
zip_flags_t.
Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>
| March 15, 2022 | NiH |