Funções de Diretórios
PHP Manual / HOSPEDAGEM / Hospedagem de Sites / Registro de Domínio / Servidor Dedicado / Revenda / Web local / Php Manual Espanhol / Php Manual Francês / Php Manual Inglês

readdir

(PHP 4, PHP 5)

readdirLê os campos do manipulador do diretório

Descrição

string readdir ( resource $dir_handle )

Retorna o nome de arquivo do próximo arquivo do diretório. Os nomes de arquivos são retornados na ordem informada pelo sistema de arquivos.

Parâmetros

dir_handle

O manipulador de diretório resource previamente aberto com opendir().

Valor Retornado

Retorna o nome do arquivo em sucesso, ou FALSE em falha.

Aviso

Esta função pode retornar o booleano FALSE, mas também pode retornar um valor não-booleano que pode ser avaliado como FALSE, como 0 ou "". Leia a seção em Booleanos para maiores informações. Utilize o operador === para testar o valor retornado por esta função.

Exemplos

Exemplo #1 Listando todos os arquivos de um diretório

Verifique cuidadosamente o estilo de checagem dos valores retornados por readdir() nos exemplos abaixo. Nós explicitamente testamos se o valor retornado é idêntico a (igual e do mesmo tipo que FALSE --- veja Operadores de Comparação para maiores detalhes). De outra forma, qualquer entrada de diretório que seja avaliada para FALSE irá parar o loop (por exemplo, um diretório nomeado "0").

<?php
// Note que !== não existia antes do PHP 4.0.0-RC2

if ($handle opendir('/path/to/files')) {
    echo 
"Manipulador de diretório: $handle\n";
    echo 
"Arquivos:\n";

    
/* Esta é a forma correta de varrer o diretório */
    
while (false !== ($file readdir($handle))) {
        echo 
"$file\n";
    }

    
/* Esta é a forma INCORRETA de varrer o diretório */
    
while ($file readdir($handle)) {
        echo 
"$file\n";
    }

    
closedir($handle);
}
?>

Exemplo #2 Listar todos os arquivos no diretório atual e retirar . e ..

<?php
if ($handle opendir('.')) {
    while (
false !== ($file readdir($handle))) {
        if (
$file != "." && $file != "..") {
            echo 
"$file\n";
        }
    }
    
closedir($handle);
}
?>

Veja Também


Funções de Diretórios
PHP Manual / HOSPEDAGEM / Hospedagem de Sites / Registro de Domínio / Servidor Dedicado / Revenda / Web local / Php Manual Espanhol / Php Manual Francês / Php Manual Inglês