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 RarArchive::getEntry(string $entryname): RarEntry|false

Estilo procedural:

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

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

Note:

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.

Note:

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

Valor Retornado

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

Exemplos

Example #1 Estilo orientado a objetos

<?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();
?>

O exemplo acima produzirá algo semelhante a:

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

Example #2 Estilo 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);
?>

Veja Também