VFileInfo

Los objetos de esta clase contienen la información de un fichero de disco. Tiene funciones generales para obtener información de la senda, el fichero y sus permisos además de permitir alterar algunas características del fichero.

Funciones

Del path

Retorno	Función
String	absoluteFilePath()
String	absolutePath()
String	baseName()
String	bundleName()
String	canonicalFilePath()
String	canonicalPath()
String	completeBaseName()
String	completeSuffix()
String	fileName()
String	filePath()
String	group()
Number	groupId()

De información

Retorno	Función
Boolean	caching()
DateTime	created()
Boolean	exists()
Boolean	isAbsolute()
Boolean	isBundle()
Boolean	isDir()
Boolean	isExecutable()
Boolean	isFile()
Boolean	isHidden()
Boolean	isReadable()
Boolean	isRelative()
Boolean	isRoot()
Boolean	isSymLink()
Boolean	isWritable()
DateTime	lastModified()
DateTime	lastRead()

De asignación

Retorno	Función
Boolean	makeAbsolute()
String	owner()
Number	ownerId()
String	path()
Boolean	permission( Number permissions )
Number	permissions()
void	refresh()
void	setCaching( Boolean bEnable )
void	setFile( String szFilePath )
Number	size()
String	suffix()
String	symLinkTarget()

Documentación de funciones

Funciones del path

String absoluteFilePath()

Devuelve el path absoluto del fichero incluyendo el nombre del fichero.

String absolutePath()

Devuelve el path absoluto del fichero sin incluir el nombre del fichero.

String baseName()

Devuelve el nombre del fichero sin incluir la senda ni la extensión. El nombre son todos los caracteres hasta el primero punto ".". Por ejemplo de "/tmp/archive.tar.gz" devolvería "archive".

String bundleName()

Devuelve el nombre del enlace al fichero. En Mac OS X devuelve el nombre del enlace, en otras plataformas devuelve una cadena vacía.

String canonicalFilePath()

Devuelve el path de la senda absoluta de un enlace simbólico del fichero incluyendo el nombre. Si el fichero no existe devuelve una cadena vacía.

String canonicalPath()

Devuelve el path de la senda absoluta de un enlace simbólico del fichero sin incluir el nombre. Si el fichero no existe devuelve una cadena vacía.

String completeBaseName()

Devuelve el nombre completo del fichero incluyendo la extensión sin la senda de la senda. Por ejemplo de "/tmp/archive.tar.gz" devolvería "archive.tar".

String completeSuffix()

Devuelve todas las extensiones del fichero. Por ejemplo, de "/tmp/archive.tar.gz" devuelve "tar.gz"

String fileName()

Devuelve el nombre del fichero excluyendo la senda. Por ejemplo, de "/tmp/archive.tar.gz" devuelve "archive.tar.gz".

String filePath()

Devuelve el nombre del fichero incluyendo la senda tanto si es absoluta o como relativa.

String group()

Devuelve el nombre del grupo del fichero.

Number groupId()

Devuelve el código (Id) del grupo del fichero. Sólo para sistemas Unix.

Funciones de información

Boolean caching()

Devuelve true si el cacheado del fichero está habilitado.

DateTime created()

Devuelve la fecha y hora de creación del fichero. En sistemas Unix esta fecha cambia tanto en la creación como si hay modificación de permisos.

Boolean exists()

Devuelve true si el fichero existe.

Boolean isAbsolute()

Devuelve true si la senda apunta a una senda absoluta.

Boolean isBundle()

Devuelve true si la senda apunta a un enlace (simbólico o paquete).

Boolean isDir()

Devuelve true si la senda apunta a un directorio.

Boolean isExecutable()

Devuelve true si la senda apunta a un fichero ejecutable.

Boolean isFile()

Devuelve true si la senda apunta a un fichero o a un enlace simbólico.

Boolean isHidden()

Devuelve true si la senda apunta a un fichero o directorio oculto.

Boolean isReadable()

Devuelve true si la senda apunta a un fichero que puede ser leído.

Boolean isRelative()

Devuelve true si la senda apunta a un senda relativa.

Boolean isRoot()

Devuelve true si la senda apunta al directorio raíz o a un enlace simbólico del mismo.

Boolean isSymLink()

Devuelve true si la senda apunta a un enlace simbólico.

Boolean isWritable()

Devuelve true si la senda apunta a un fichero en el que se puede escribir.

DateTime lastModified()

Devuelve la fecha y hora de la última modificación del fichero.

DateTime lastRead()

Devuelve la fecha y hora de la última vez que el fichero fue leído o tuvo un acceso.

Funciones de asignación

Boolean makeAbsolute()

Convierte el path del fichero en un senda absoluta. Devuelve true si la conversión ha finalizado correctamente. Si el path ya era absoluto devuelve false.

String owner()

Devuelve el nombre del propietario del fichero.

Number ownerId()

Devuelve el código (Id) del propietario del fichero

String path()

Devuelve la senda del fichero

Boolean permission( Number permissions )

Chequea los permisos del fichero y devuelve true si el fichero los tiene.

Parámetros:

• permissions: number que indica los permisos. Ver enum de tipos de permisos del fichero en la clase VFile

Number permissions()

Devuelve el valor de los permisos del fichero. El valor devuelto es la suma (OR) de los valores de los permisos. Ver enum de permisos del fichero.

void refresh()

Refresca la información del fichero.

void setCaching( Boolean bEnable )

Establece si el sistema tendrá caché de la información del fichero.

Parámetros:

• bEnable: booleano que indica true para que el sistema haga caché de la información del fichero.

void setFile( String szFilePath )

Fija el fichero o directorio al que apuntará el objeto.

Parámetros:

• szFilePath = Path del fichero o directorio.

Number size()

Devuelve el tamaño del fichero en bytes.

String suffix()

Devuelve la extensión del fichero.

String symLinkTarget()

Devuelve la senda absoluta del fichero apuntado por el enlace simbólico o acceso directo.

Ejemplos

1. Ejemplo de lectura de los ficheros del directorio raíz del sistema

////////////////////////////////////////////////////////////
// Ejemplo de lectura de los ficheros del directorio raíz del sistema

// Para poder usar la clase VDir y sus funciones hay que importarla primero
importClass( "VDir" );

// Ss crear un objeto VDir con el directorio temporal de la aplicación
var dir = new VDir( theApp.rootPath() );

// Cargar la lista de ficheros y directorios
dir.load();

// Se inicializan las variables de trabajo
var filesNumber =0;
var totalSize = 0;
var filesList = "";

// Se recorren todos los ficheros del directorio
for ( i=0; i < dir.count(); i++ )
{
    // Se lee el fichero (Se obtiene un objeto VTableInfo)
    file = dir.entryAt( i );

    // Si es fichero se acumulan sus datos
    if ( file.isFile() ) {
        filesNumber++;
        totalSize += file.size();
        filesList += dir.entryAt( i ).filePath(file.path() ) + "\n";
    }
}

// Se visualizan los datos de todos los ficheros del directorio
alert( "En el directorio raíz (" + dir.path() + ")" + "\n" + 
        "Se han encontrado " + filesNumber.toString() + " ficheros: \n\n" + 
        filesList + "\n" + 
        "El tamaño total de los ficheros es " +  totalSize.toString() + " bytes." );