zip_name_locate man page

zip_name_locate — get index of file by name


libzip (-lzip)


#include <zip.h>


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. The flags are specified by or'ing the following values, or 0 for none of them.


Ignore case distinctions. (Will only work well if the file names are ASCII.)


Ignore directory part of file name in archive.


Compare against the unmodified names as it is in the ZIP archive.


(Default.) Guess the encoding of the name in the ZIP archive and convert it to UTF-8, if necessary, before comparing.


Follow the ZIP specification and expect CP-437 encoded names in the ZIP archive (except if they are explicitly marked as UTF-8). Convert it to UTF-8 before comparing.

Note: ASCII is a subset of both CP-437 and UTF-8.

Return Values

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:


No entry of the name fname is found in the archive.


One of the arguments is invalid.


Required memory could not be allocated.

See Also

libzip(3), zip_get_name(3)


Dieter Baron <> and Thomas Klausner <>

Referenced By

libzip(3), zip_fopen(3), zip_fopen_encrypted(3), zip_get_name(3), zip_stat(3).

July 21, 2012 NiH Library Functions Manual