RarArchive::getEntry

rar_entry_get

Get entry object from the RAR archive

&reftitle.description;

&style.oop; (method):

public ``RarEntry``false```RarArchive::getEntry` `string` `entryname`

&style.procedural;:

``RarEntry``false```rar_entry_get` `RarArchive` `rarfile` `string` `entryname`

Get entry object (file or directory) from the RAR archive.

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.

&reftitle.parameters;

`rarfile`

- A `RarArchive` object, opened with `rar_open`.

`entryname`

- Path to the entry within the RAR archive.

  The path must be the same returned by `RarEntry::getName`.

&reftitle.returnvalues;

Returns the matching `RarEntry` object &return.falseforfailure;.

&reftitle.examples;

### &style.oop;

    <?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 not get such entry");
    echo get_class($rar_entry)."\n";
    echo $rar_entry;
    $rar_arch->close();
    ?>

&example.outputs.similar;

    RarEntry
    RarEntry for file "tese.txt" (23b93a7a)

### &style.procedural;

    <?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 not get such entry");
    echo get_class($rar_entry)."\n";
    echo $rar_entry;
    rar_close($rar_arch);
    ?>

&reftitle.seealso;

- `RarArchive::getEntries`
- `rar://` wrapper