readdir

(PHP 3, PHP 4, PHP 5)

readdir -- Leer una entrada desde un gestor de directorio

Descripción

string readdir ( resource gestor_dir )

Devuelve el nombre del siguiente archivo leido desde el directorio. Los nombres de archivo son devueltos en el orden en que son almacenados por el sistema de archivos.

Lista de parámetros

gestor_dir

El gestor de directorio tipo resource abierto previamente con opendir().

Valores retornados

Devuelve el nombre de archivo en caso de éxito, o FALSE si ocurre un error.

Ejemplos

Ejemplo 1. Listar todos los archivos en un directorio

Por favor note la forma en que el valor de retorno de dir() es chequeado en los siguientes ejemplos. Se está probando explícitamente si el valor de retorno es idéntico (igual y del mismo tipo que--vea los Operadores de Comparación para más información) a FALSE ya que de otra forma, cualquier entrada de directorio cuyo nombre evalúe a FALSE detendrá el ciclo (p.ej. un directorio llamado "0").

<?php
// Note que !== no existia hasta 4.0.0-RC2

if ($gestor = opendir('/ruta/a/archivos')) {
    echo
"Gestor de directorio: $gestor\n";
    echo
"Archivos:\n";

    
/* Esta es la forma correcto de iterar sobre el directorio. */
    
while (false !== ($archivo = readdir($gestor))) {
        echo
"$archivo\n";
    }

    
/* Esta es la forma EQUIVOCADA de iterar sobre el directorio. */
    
while ($archivo = readdir($gestor)) {
        echo
"$archivo\n";
    }

    
closedir($gestor);
}
?>

Ejemplo 2. Listar todos los archivos en el directorio actual y eliminar . y ..

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

Ver también

is_dir()
glob()

Hosting by: hurra.com
Generated: 2007-01-26 18:00:49