Manual de PHP
AnteriorSiguiente

scandir

(PHP 5)

scandir --  Lista los archivos y directorios ubicados en la ruta especificada

Descripción

array scandir ( string directorio [, int sentido_de_ordenamiento [, resource contexto]] )

Devuelve un array de archivos y directorios que se encuentran bajo directorio.

Lista de parámetros

directorio

El directorio que será procesado.

sendito_de_ordenamiento

Por defecto, el sentido del ordenamiento es ascendente. Si es usado el parámetro opcional sentido_de_ordenamiento (definido como 1), entonces el sentido será descendente.

context

Para una descripción del parámetro contexto, refiérase a la sección de secuencias del manual.

Valores retornados

Devuelve un valor array con nombres de archivo en case de éxito, o FALSE en caso de fallo. Si directorio no es un directorio, entonces el valor booleano FALSE es retornado, y se genera un error de nivel E_WARNING.

Ejemplos

Ejemplo 1. Un ejemplo simple de scandir()

<?php
$dir    = '/tmp';
$archivos1 = scandir($dir);
$archivos2 = scandir($dir, 1);

print_r($archivos1);
print_r($archivos2);
?>

El resultado del ejemplo seria algo similar a:

Array
(
    [0] => .
    [1] => ..
    [2] => bar.php
    [3] => directorio_cualquiera
    [4] => foo.txt
)
Array
(
    [0] => foo.txt
    [1] => directorio_cualquiera
    [2] => bar.php
    [3] => ..
    [4] => .
)

Ejemplo 2. Alternativas a scandir() con PHP 4

<?php
$dir = "/tmp";
$dh  = opendir($dir);
while (false !== ($nombre_archivo = readdir($dh))) {
    $archivos[] = $nombre_archivo;
}

sort($archivos);

print_r($archivos);

rsort($archivos);

print_r($archivos);

?>

El resultado del ejemplo seria algo similar a:

Array
(
    [0] => .
    [1] => ..
    [2] => bar.php
    [3] => directorio_cualquiera
    [4] => foo.txt
)
Array
(
    [0] => foo.txt
    [1] => directorio_cualquiera
    [2] => bar.php
    [3] => ..
    [4] => .
)

Notes

Sugerencia: Puede usar una URL como nombre de archivo con esta función si los fopen wrappers han sido activados. Consulte fopen() para más detalles sobre cómo especificar el nombre de fichero y Apéndice M una lista de protocolos URL soportados

Ver también

opendir()
readdir()
glob()
is_dir()
sort()

AnteriorInicioSiguiente
rewinddirSubirDOM Functions

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