Lê entrada do manipulador do diretório

Descrição

readdir(?resource $dir_handle = null): string|false

Retorna o nome da próxima entrada do diretório. As entradas são retornadas na ordem em que estão armazenadas no sistema de arquivos.

Parâmetros

dir_handle: O manipulador de diretório do tipo resource previamente aberto por opendir(). Se dir_handle for null, o último manipulador aberto por opendir() será usado.

Valor Retornado

Retorna o nome do arquivo em caso de sucesso, ou false em caso de falha.

Aviso

Esta função pode retornar o valor booleano false, mas também pode retornar um valor não booleano que pode ser avaliado como false. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

Registro de Alterações

Versão	Descrição
8.5.0	Usar `null` para `dir_handle` foi descontinuado. Em vez disso, o manipulador do último diretório aberto deve ser fornecido explicitamente.
8.0.0	`dir_handle` agora pode ser nulo.

Exemplos

Para um exemplo completo, consulte a documentação de opendir().

Veja Também

opendir() - Abre um manipulador de diretório
rewinddir() - Retroceder o manipulador de diretório
closedir() - Fecha o manipulador do diretório
dir() - Retorna uma instância da classe Directory
is_dir() - Diz se o caminho é um diretório
glob() - Encontra caminhos que combinam com uma expressão
scandir() - Lista arquivos e diretórios dentro do caminho especificado