RAR_ENTRY_GET(3) 1 RAR_ENTRY_GET(3)
RarArchive::getEntry - Get entry object from the RAR archive
Object oriented style (method):
SYNOPSIS
public RarEntry RarArchive::getEntry (string $entryname)
DESCRIPTION
Procedural style:
RarEntry rar_entry_get (RarArchive $rarfile, string $entryname)
Get entry object (file or directory) from the RAR archive.
Note
You can also get entry objects using RarArchive::getEntries.
Note that a RAR archive can have multiple entries with the same name; this method will retrieve only the first.
PARAMETERS
o $rarfile
- A RarArchive object, opened with rar_open(3).
o $entryname
- Path to the entry within the RAR archive.
Note
The path must be the same returned by RarEntry::getName.
RETURN VALUES
Returns the matching RarEntry object or FALSE on failure.
EXAMPLES
Example #1
Object oriented style
<?php
$rar_arch = RarArchive::open('solid.rar');
if ($rar_arch === FALSE)
die("Could not open RAR archive.");
$rar_entry = $rar_arch->getEntry('tese.txt');
if ($rar_entry === FALSE)
die("Could get such entry");
echo get_class($rar_entry)."
";
echo $rar_entry;
$rar_arch->close();
?>
The above example will output something similar to:
RarEntry
RarEntry for file "tese.txt" (23b93a7a)
Example #2
Procedural style
<?php
$rar_arch = rar_open('solid.rar');
if ($rar_arch === FALSE)
die("Could not open RAR archive.");
$rar_entry = rar_entry_get($rar_arch, 'tese.txt');
if ($rar_entry === FALSE)
die("Could get such entry");
echo get_class($rar_entry)."
";
echo $rar_entry;
rar_close($rar_arch);
?>
SEE ALSO
RarArchive::getEntries, rar:// wrapper.
PHP Documentation Group RAR_ENTRY_GET(3)