VTextFile
Esta clase representa a un fichero de texto y disponemos de funciones para consultar sus caracterÃsticas, modificarlas asà como crear, leer o escribir un fichero de texto en disco.
Nombres de códigos
- "Apple Roman"
- "Big5"
- "Big5-HKSCS"
- "CP949"
- "EUC-JP"
- "EUC-KR"
- "GB18030-0"
- "IBM 850"
- "IBM 866"
- "IBM 874"
- "ISO 2022-JP"
- "ISO 8859-1 to 10"
- "ISO 8859-13 to 16"
- "Iscii-Bng, Dev, Gjr, Knd, Mlm, Ori, Pnj, Tlg, and Tml"
- "JIS X 0201"
- "JIS X 0208"
- "KOI8-R"
- "KOI8-U"
- "MuleLao-1"
- "ROMAN8"
- "Shift-JIS"
- "TIS-620"
- "TSCII"
- "UTF-8"
- "UTF-16"
- "UTF-16BE"
- "UTF-16LE"
- "UTF-32"
- "UTF-32BE"
- "UTF-32LE"
- "Windows-1250 to 1258"
- "WINSAMI2"
Crea una instancia de objeto de la clase VTextFile. Requiere importar previamente la clase: importClass( "VTextFile" ).
Parámetros:
- szFileName: string que establece la senda del fichero de texto
Devuelve true si el fin de fichero ha sido leÃdo.
Cierra el fichero.
Devuelve el code del fichero.
En Windows, el codec por defecto se basa en la configuración local. En sistemas Linux y Mac hará uso de la librerÃa iconv si no hay configurado un codec local. En ambos casos, el nombre de codec que se devolverÃa la función codec de VTextFile serÃa "System".
Devuelve el código numérico del error.
Devuelve true si el fichero existe, false en caso contrario.
Devuelve el nombre del fichero.
Fuerza que se guarden todos los buffers a disco.
Abre el fichero. Devuelve true si ha podido abrirlo.
Abre el fichero con los modos especificados. Los modos de apertura son combinables. Se pueden especificar varios separados por "|".
Parámetros:
- nMode: número que indica el modo de apertura. Ver enum de flags de modos de apertura del fichero. Los valores con combinables mediante el uso del operador bitwise or booleano "|".
Devuelve el código numérico de los permisos. Ver enum de permisos del fichero.
Devuelve la posición actual en el fichero.
Devuelve el contenido completo del fichero.
Devuelve el contenido de una lÃnea.
Parámetros:
- nMaxlen: número que establece la longitud máxima a devolver, por defecto 0 = hasta fin de lÃnea.
Establece la posición del fichero. Devuelve true si el posicionamiento finaliza correctamente.
Parámetros:
- nOffset: número que establece la posición.
Establece el codec para codificar los datos que escriben. Debemos aplicar esta función sobre el objeto VTextFile creado antes de escribir.
Parámetros:
- szCodecName: cadena que indica el codec. Ver lista de nombres de códigos.
En Windows, el codec por defecto se basa en la configuración local. En sistemas Linux y Mac hará uso de la librerÃa iconv si no hay configurado un codec local. En ambos casos, el nombre de codec que se devolverÃa la función codec de VTextFile serÃa "System".
Establece los permisos del fichero.
Parámetros:
- nPermissions: número que define los permisos del fichero. Ver enum de permisos de un fichero.
Devuelve el tamaño en bytes del fichero.
Establece el error del fichero al valor del enum
::NoError.
Graba una cadena de texto en la posición en curso.
Parámetros:
- szTexto: cadena que establece el texto a grabar.
Hace una copia del fichero en curso con otro nombre o path.
Devuelve true si la copia ha podido realizarse con éxito.
Parámetros:
- szNewName: cadena que indica la senda donde se almacenará la copia del fichero
Elimina el fichero en curso.
Devuelve true si se ha eliminado correctamente.
Renombra el fichero en curso.
Devuelve true si ha podido renombrarse correctamente. Si el fichero con el nombre szNewName ya existe devuelve false.
Parámetros:
- szNewName: cadena que indica el nombre o senda nueva para el fichero.
Cambia el tamaño del fichero.
Devuelve true si ha podido realizarse correctamente.
Parámetros:
- nSize: número que indica el número de bytes del nuevo tamaño del fichero
////////////////////////////////////////////////////////////
// Ejemplo de creación de un fichero de texto
​
// Para usar las funciones de la clase VFile primero hay que importarla
importClass( "VTextFile" );
importClass( "VFile" );
​
// Se declara el objeto fichero
var fi = new VTextFile( "/TextFile.txt" );
​
// Se abre el fichero en modo escritura. Crea si no existe o limpia si existe
if ( fi.open( VFile.OpenModeWriteOnly | VFile.OpenModeTruncate) )
{
// Se llena el buffer con las 26 letras del abecedario
for( var x=0; x < 30; ++x )
{
fi.write( "LÃnea " + x + " de texto a grabar" + "\n" );
}
​
// Se cierra el fichero
fi.close();
}
else
// Si no ha sido posible abrir el fichero se muestra error
alert( "No se pudo abrir el fichero " + fi.fileName() + ", error " + fi.error(), "Error" );
////////////////////////////////////////////////////////////
// Ejemplo de lectura de un fichero de texto
​
// Para usar las funciones de la clase VFile primero hay que importarla
importClass( "VTextFile" );
importClass( "VFile" );
​
// Se declara el objeto fichero
var fi = new VTextFile( "/TextFile.txt" );
​
// Se abre el fichero en modo de sólo lectura
if ( fi.open( VFile.OpenModeReadOnly ) )
{
// Leer todo el fichero
alert( "Tamaño del fichero = " + fi.size() + " bytes" );
​
// Leer todo el fichero
alert( fi.readAll() );
​
// Como hemos leÃdo todo el fichero estamos posicionados al final
// Para volver a leer el fichero lÃnea a lÃnea nos posicionamos al principio
fi.seek( 0 );
​
// Recorremos el fichero lÃnea a lÃnea guardando su contenido
var txt = "";
​
while ( fi.atEnd() == false )
{
txt += fi.readLine();
}
​
// Mostramos la variable con todo el contenido del fichero
alert( txt );
​
// Se cierra el fichero
fi.close();
}
else {
// Si no ha sido posible abrir el fichero se muestra error
alert( "No se pudo abrir el fichero " + fi.fileName() + ", error " + fi.error(), "Error" );
}
Última actualización 1yr ago