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.
Funciones
Constructor
Función |
Generales
Retorno | Función |
Boolean | |
void | |
void | |
Number | |
Boolean | |
String | |
void | |
Boolean | |
Number | |
Number | |
String | |
String | |
Boolean | |
void | |
Boolean | |
Number | |
void | |
void |
De operaciones sobre ficheros
Retorno | Función |
Boolean | |
Boolean | |
Boolean | |
Boolean |
Enumeraciones
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"
Documentación de funciones
Constructor
VTextFile( String szFileName )
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
Funciones generales
Boolean atEnd()
Devuelve true si el fin de fichero ha sido leído.
void close()
Cierra el fichero.
void codec()
Devuelve el code del fichero.
Nota:
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".
Number error()
Devuelve el código numérico del error.
Boolean exists()
Devuelve true si el fichero existe, false en caso contrario.
String fileName()
Devuelve el nombre del fichero.
void flush()
Fuerza que se guarden todos los buffers a disco.
Boolean open( Number nMode )
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: Number 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 "|".
Number permissions()
Devuelve el codigo numérico de los permisos. Ver enum de permisos del fichero.
Number pos()
Devuelve la posición actual en el fichero.
String readAll()
Devuelve el contenido completo del fichero.
String readLine( Number nMaxlen=0 )
Devuelve el contenido de una línea.
Parámetros:
nMaxlen: Number que establece la longitud máxima a devolver, por defecto 0 = hasta fin de línea.
Boolean seek( Number nOffset )
Establece la posición del fichero. Devuelve true si el posicionamiento finaliza correctamente.
Parámetros:
nOffset: Number que establece la posición.
void setCodec( String szCodecName )
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: String que indica el codec. Ver lista de nombres de códigos.
Nota:
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".
Boolean setPermissions( Number nPermissions )
Establece los permisos del fichero.
Parámetros:
nPermissions: Number que define los permisos del fichero. Ver enum de permisos de un fichero.
Number size()
Devuelve el tamaño en bytes del fichero.
void unsetError()
Establece el error del fichero al valor del enum
::NoError.
void write( String szText )
Graba una cadena de texto en la posición en curso.
Parámetros:
szTexto: String que establece el texto a grabar.
Funciones de operaciones sobre ficheros
Boolean copy( String szNewName )
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: String que indica la senda donde se almacenará la copia del fichero
Boolean remove()
Elimina el fichero en curso.
Devuelve true si se ha eliminado correctamente.
Boolean rename( String szNewName )
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: String que indica el nombre o senda nueva para el fichero.
Boolean resize( Number nSize )
Cambia el tamaño del fichero.
Devuelve true si ha posido realizarse correctamente.
Parámetros:
nSize: Number que indica el número de bytes del nuevo tamaño del fichero
Ejemplos
1. Ejemplos de creación de un fichero de texto
2. Ejemplos de lectura de un fichero de texto
Última actualización