English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
PHP Directory Referência Manual
A função readdir() lê itens do handle de diretório
Sintaxe
Definição e uso
Parâmetro | Número |
---|---|
1 | Parâmetros e descrição dir_handle(obrigatório) |
Retorno
Retorna o nome do arquivo com sucesso, ou FALSE em caso de falha.
Atenção: Esta função pode retornar o valor booleano FALSE, mas também pode retornar valores não booleanos equivalentes a FALSE. Por favor, leia a seção sobre Tipos Booleanos para mais informações. Deve-se usar o operador === para testar o retorno da função.
Por favor, note o estilo de verificação do retorno de readdir() no exemplo a seguir. Aqui é testado explicitamente se o valor retornado é completamente igual a FALSE (tanto no valor quanto no tipo - mais informações em operadores de comparação), caso contrário, qualquer item de diretório cujo nome é avaliado como FALSE fará com que o loop pare (por exemplo, um diretório chamado "0"). Exemplo/$dir = opendir("/var/www images"); while (($file = readdir($dir)) !== false) { /echo "nome_do_arquivo: " . $file . "<br" } >"; ?>
closedir($dir);
Resultados de saída nome_do_arquivo: . nome_do_arquivo: .. nome_do_arquivo: logo.gif
Exemplo online
Listar todos os arquivos do diretório:
Por favor, note o estilo de verificação do retorno de readdir() no exemplo a seguir. Aqui é testado explicitamente se o valor retornado é completamente igual a FALSE (tanto no valor quanto no tipo - mais informações em operadores de comparação), caso contrário, qualquer item de diretório cujo nome é avaliado como FALSE fará com que o loop pare (por exemplo, um diretório chamado "0"). // <?php 4Atenção em-.0.02 RC Antes não existia !== operador/if ($handle = opendir('/path/to echo "Manejador de diretório: $handle\n"; echo "Arquivos:\n"; /* Esta é uma maneira correta de percorrer um diretório */ while (false !== ($file = readdir($handle))) { echo "\n$file"; } /* Esta é uma maneira incorreta de percorrer um diretório */ while ($file = readdir($handle)) { echo "\n$file"; } closedir($handle); } ?>