Obtém o objeto de entrada do arquivo RAR

# RarArchive::getEntry

# rar_entry_get

(PECL rar >= 2.0.0)

RarArchive::getEntry -- rar_entry_get — Obtém o objeto de entrada do arquivo RAR

### Descrição

Estilo orientado a objetos (method):

public function RarArchive::getEntry(string `$entryname`): RarEntry|false

Estilo procedural:

function rar_entry_get(RarArchive `$rarfile`, string `$entryname`): RarEntry|false

Obtém o objeto de entrada (arquivo ou diretório) do arquivo RAR.

> Nota: Você também pode obter objetos de entrada usando RarArchive::getEntries(). Observe que um arquivo RAR pode ter múltiplas entradas com o mesmo nome; este método recuperará apenas o primeiro.

### Parâmetros

`rarfile`
  Um objeto RarArchive, aberto com rar_open().
`entryname`
  Caminho para a entrada no arquivo RAR.

  > Nota: O caminho deve ser o mesmo retornado por RarEntry::getName().

### Valor Retornado

Retorna o objeto RarEntry correspondente ou `false` em caso de falha.

### Exemplos

Exemplo #1 Estilo orientado a objetos

    <?php
    $rar_arch = RarArchive::open('solid.rar');
    if ($rar_arch === FALSE)
        die("Não foi possível abrir o arquivo RAR.");
    $rar_entry = $rar_arch->getEntry('tese.txt');
    if ($rar_entry === FALSE)
        die("Não foi possível recupera esta entrada");
    echo get_class($rar_entry)."\n";
    echo $rar_entry;
    $rar_arch->close();
    ?>

O exemplo acima produzirá algo semelhante a:

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

Exemplo #2 Estilo procedural

    <?php
    $rar_arch = rar_open('solid.rar');
    if ($rar_arch === FALSE)
        die("Não foi possível abrir o arquivo RAR.");
    $rar_entry = rar_entry_get($rar_arch, 'tese.txt');
    if ($rar_entry === FALSE)
        die("Não foi possível recupera esta entrada");
    echo get_class($rar_entry)."\n";
    echo $rar_entry;
    rar_close($rar_arch);
    ?>

### Veja Também

- RarArchive::getEntries() - Obtém a lista completa de entradas do arquivo RAR
- Empacotador `rar://`

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open