GETLIST

Obetener la lista de los archivos de un directorio actual, local o remoto

Sintasis: GETLIST(variable_name,list_type,filter)

  • variable_nombre: GETLIST guardar la lista de esta variable. Por lo general, esta variable se utiliza en el FOREACH bucle.
  • lista_tipo:
    LOCAL_FILESLista de archivos locales
    LOCAL_DIRECTORIESLista de directorios locales
    REMOTE_FILESlistas de archivos remotos
    REMOTE_DIRECTORIESListas de directorios remotos

  • comodn (opcional):Si este parmetro es utilizado GETLIST solo incluir en la lista resultante de los archivos o directorios que coincidan con este comodn. Por ejemplo "*.txt" har a GETLIST crear una lista de archivos de texto.

Remarks:

  • La lista resultante se puede utilizar en el FOREACH bucle. De esta manera usted puede hacer en ScriptFTP una serie de acciones diferentes, para cada archivo de la lista.
  • Todas las variables de ScriptFTP contienen una cadena de texto, y la lista que este comando crea no es una excepcin. El caracter "|" es utilizado para separar los elementos de la lista. Por o tanto, tambin se pueden crear listas de archivos sin GETLIST. por ejemplo: $mylist="a.txt|b.txt|c.txt".

Valor retorno:
Este comando devolver "OK" si no se encontr error al recuperar la lista de archivos.

Histrico de comandos:
Este comando se aadi a ScriptFTP 3.0 realizado el 28 de Julio de 2008

Ver tambin:
FOREACH
COUNTELEMENTS

Ejemplos:

# Conectar al servidor
OPENHOST("ftp.myhost.com","joe","123456")

# Cambiar al directorio local actual. Todos los archivos
# Se puede descargar aqu.
LOCALCHDIR("C:\users\carlos\desktop\localftp")

# Obtener la lista de archivos remotos. Guardar en el$list
GETLIST($list,REMOTE_FILES,"*.txt")

# Para cada archivo en $list...
FOREACH $item IN $list
       # Descargar el archivo
       $result=GETFILE($item)
       # Si el archivo se ha descargado satisfactoriamente.
       # borra la copia remota, de lo contrario detener el script.
       IF($result=="OK")
              DELETEFILE($item)
       ELSE
              STOP
       END IF
END FOREACH

# Cerrar la conexin
CLOSEHOST

# Conectar al servidor
OPENHOST("127.0.0.1","carl","123456")

# Obtener el listado del directorio remoto. Gurdelo en $list
GETLIST($list,REMOTE_DIRECTORIES)

# Para cada directorio en $list imprime el nombre
FOREACH $item IN $list
       PRINT($item)
END FOREACH


# Obtener el listado del directorio local, gurdelo en el $list
GETLIST($list,LOCAL_DIRECTORIES)

# Para cada directorio en $list imprime el nombre
FOREACH $item IN $list
       PRINT($item)
END FOREACH

# Cerrar la conexin
CLOSEHOST