Manual do PHP
Anterior |  | Próxima

# readdir

(PHP 3, PHP 4 , PHP 5)

readdir -- Lê 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.

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").

Exemplo 1. Lista todos os arquivos em um diretório
`<?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); } ?>`

Note que readdir() irá retornar o . e .. . Se você não quer estes simplesmente os retire:

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 is_dir() e glob().

Anterior | Principal | Próxima
opendir | Acima | rewinddir