Leer entrada desde el manejador de directorio

Descripción

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

Devuelve el nombre de la siguiente entrada en el directorio. Las entradas se devuelven en el orden en que están almacenadas por el sistema de archivos.

Parámetros

dir_handle: Un manejador de directorio resource previamente abierto con opendir(). Si dir_handle es null se utilizará el último manejador abierto usando opendir().

Valores devueltos

Devuelve el nombre de la entrada en caso de éxito, o false si ocurre un error.

Advertencia

Esta función puede retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de esta función.

Historial de cambios

Versión	Descripción
8.5.0	Usar `null` para `dir_handle` ahora está deprecado. En su lugar, debe proporcionarse explícitamente el último manejador de directorio abierto.
8.0.0	`dir_handle` ahora es nullable.

Ejemplos

Para un ejemplo completo, consulte la documentación de opendir().

Ver también

opendir() - Abrir un manejador de directorio
rewinddir() - Reinicia el gestor de directorio
closedir() - Cerrar el gestor de directorio
dir() - Devuelve una instancia de la clase Directory
is_dir() - Indica si el fichero es un directorio
glob() - Búsqueda de rutas que coinciden con un patrón
scandir() - Lista los ficheros y directorios en un directorio