# ZipArchive::locateName

(No version information available, might be only in CVS)

ZipArchive::locateName — Returns the index of the entry in the archive

### Description

mixed ZipArchive::locateName ( string `$name` [, int `$flags` ] )

Locates an entry using its name.

### Parameters

`name`

  The name of the entry to look up

`flags`

  The function returns the index of the file named fname in archive. The flags are specified by ORing the following values, or 0 for none of them.

  - `ZIPARCHIVE::FL_NOCASE`

  - `ZIPARCHIVE::FL_NODIR`

### Return Values

Returns the index of the entry on success or `FALSE` on failure.

### Examples

Example#1 Create an archive and then use it with locateName

`<?php
$file = 'testlocate.zip';
$zip = new ZipArchive;
if ($zip->open($file, ZIPARCHIVE::CREATE) !== TRUE) {
exit('failed');
}
$zip->addFromString('entry1.txt', 'entry #1');
$zip->addFromString('entry2.txt', 'entry #2');
$zip->addFromString('dir/entry2d.txt', 'entry #2');
if (!$zip->status == ZIPARCHIVE::ER_OK) {
echo "failed to write zip\n";
}
$zip->close();
if ($zip->open($file) === TRUE) {
exit('failed');
}
echo $zip->locateName('entry1.txt') . "\n";
echo $zip->locateName('eNtry2.txt') . "\n";
echo $zip->locateName('eNtry2.txt', ZIPARCHIVE::FL_NOCASE) . "\n";
echo $zip->locateName('enTRy2d.txt', ZIPARCHIVE::FL_NOCASE|ZIPARCHIVE::FL_NODIR) . "\n";
$zip->close();
?>`