Indice de contenido
-> Capítulo 12 - Funciones para archivos
A continuación se describe el uso de las siguientes funciones predeterminadas en TEIMSI:
1)- binary_read(senda)
2)- binary_write(senda,cadena)
3)- closeh(manejador)
4)- deletefile(senda)
5)- fileexists(senda)
6)- filesize(senda)
7)- getatt(senda)
8)- openrand(senda)
9)- openread(senda)
10)- openwrite(senda)
11)- read(manejador,cantidad)
12)- seek(manejador,posición)
13)- setatt(senda,valor)
14)- seteof(manejador)
15)- write(manejador,cadena)
binary_read
La función "binary_read", lee todo el contenido de un archivo y lo carga en una variable tipo cadena de TEIMSI.
Sintaxis
Parámetros
cadena
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
Valor devuelto
cadena/null
| Variable tipo cadena de TEIMSI. Si el archivo no existe devuelve "null" (que es "igual" al booleano false). |
Ejemplo:
var cadena=binary_read("archivo.txt")
alert("Hay archivo ?, Respuesta = " + (cadena!=false))
alert(cadena)
Ver también <<
binary_write>>, <<
fileexists>>
Volver arriba
binary_write
La función "binary_write", escribe (sobre-escribe si ya existe) en un archivo todo el contenido de una variable tipo cadena.
Sintaxis
binary_write(senda,cadena) |
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
cadena
| Variable tipo cadena de TEIMSI. Datos a escribir en el archivo. |
Valor devuelto
booleano
| Variable tipo booleano de TEIMSI que indica el resultado de la función. Si resulta "false" puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ejemplo:
var nombre="archivo.txt"
if(binary_write(nombre, "Raíz cuadrada de 77= "+sqrt(77))){
openapp(nombre)
}else{
alert("Error "+err_number()+_nl+err_description(err_number()))
}
Ver también <<
binary_read>>, <<
err_description>>, <<
err_number>>, <<
openapp>>
Volver arriba
closeh
La función "closeh", cierra un archivo cuyo manejador (número entero) fue devuelto por alguna de las siguientes funciones: openrand, openread, openwrite.
Sintaxis
Parámetros
manejador
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. |
Valor devuelto
booleano
| Variable tipo booleano de TEIMSI que indica el resultado de la función. Si resulta "false" puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ejemplo:
var nombre="archivo.txt"
var manejador=openwrite(nombre)
if(manejador==false){
alert("Error "+err_number()+_nl+err_description(err_number()))
sys.quit()
}
write(manejador,"Dato.")
closeh(manejador)
Ver también <<
openrand>>, <<
openread>>, <<
openwrite>>, <<
write>>
Volver arriba
deletefile
La función "deletefile", borra un archivo en el sistema de archivos.
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
Valor devuelto
booleano
| Variable tipo booleano de TEIMSI que indica el resultado de la función. Si resulta "false" puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ver también <<
fileexists>>
Volver arriba
fileexists
La función "fileexists", determina si un archivo o directorio existe.
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo o directorio. |
Valor devuelto
booleano
| Variable tipo booleano de TEIMSI que indica el resultado de la función. |
Ejemplo:
alert(fileexists("c:\\ "))
Ver también <<
filesize>>
Volver arriba
filesize
La función "filesize", devuelve el tamaño de un archivo en una variable tipo entero o de precisión doble , o -1 si no existe. Si el tamaño excede 2147483647 bytes el valor devuelto es un número de precisión doble en lugar de un entero.
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
Valor devuelto
variable numérica con el tamaño o el entero -1 si el archivo no existe. |
Ver también <<
fileexists>>
Volver arriba
getatt
La función "getatt", carga los atributos de un archivo en un entero con ciertos bits activados según los mismos atributos (lectura, oculto, directorio, Etc.).
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
Valor devuelto
atributos/booleano
| Entero de 32 bits con los atributos (lectura, oculto, Etc.) o "false" si el archivo no existe. Las siguientes constantes pueden utilizarse para evaluar el entero devuelto: _att_archive, _att_compressed, _att_directory, _att_hidden, _att_normal, _att_readonly, _att_system, _att_temporary. |
Ejemplo:
var nombre="archivo.txt"
var result=getatt(nombre)
if(result===false){
alert("Error "+err_number()+_nl+err_description(err_number()))
}else{
alert("El archivo " + nombre + ", tiene atributo de ser sólo de lectura = " + ((result & _att_readonly) != 0) );
}
Ver también <<
setatt>>
Volver arriba
openrand
La función "openrand", abre un archivo para acceso aleatorio (escritura o lectura).
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
Valor devuelto
manejador/booleano
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. Si ocurrió un error devuelve "false" y puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ejemplo:
var nombre="archivo.txt"
var resultado1=binary_write(nombre, "abcdefghij")
if(resultado1){
var manejador=openrand(nombre)
}
if((resultado1==false) || (manejador==false)){
alert("Error "+err_number()+_nl+err_description(err_number()))
sys.quit()
}
seek(manejador,3)
var letra=read(manejador,1)
closeh(manejador)
alert("letra leída = "+letra) // Muestra la letra "d"
Ver también <<
openread>>
Volver arriba
openread
La función "openread", abre un archivo para acceso de lectura.
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
Valor devuelto
manejador/booleano
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. Si ocurrió un error devuelve "false" y puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ver también <<
openwrite>>
Volver arriba
openwrite
La función "openwrite", abre un archivo para acceso de escritura.
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
Valor devuelto
manejador/booleano
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. Si ocurrió un error devuelve "false" y puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ver también <<
openread>>
Volver arriba
read
La función "read", lee datos desde un archivo cuyo manejador (número entero) fue devuelto por alguna de las siguientes funciones: "openrand" o "openread".
Sintaxis
Parámetros
manejador
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. |
cantidad
| Variable tipo número entero de 32 bits de TEIMSI. Indica cuantos bytes a leer. |
Valor devuelto
Ejemplo:
Ver también <<
write>>, <<
openrand>>
Volver arriba
seek
La función "seek", mueve el puntero de lectura/escritura en un archivo cuyo manejador (número entero) fue devuelto por alguna de las siguientes funciones: openrand, openread, openwrite.
Sintaxis
seek(manejador,desplazamiento) |
Parámetros
manejador
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. |
desplazamiento
| Variable tipo número entero de 32 bits de TEIMSI. Indica el desplazamiento en bytes desde el principio del archivo. |
Valor devuelto
booleano
| Variable tipo booleano de TEIMSI que indica el resultado de la función. Si resulta "false" puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ejemplo:
Ver también <<
seteof>>, <<
closeh>>, <<
openrand>>
Volver arriba
setatt
La función "setatt", establece los atributos de un archivo mediante un entero con ciertos bits activados según los mismos atributos (lectura, oculto, directorio, Etc.).
Sintaxis
Parámetros
senda
| Variable tipo cadena de TEIMSI. Indica la senda al archivo. |
atributos
| Entero de 32 bits con los atributos (lectura, oculto, Etc.). (valor previamente devuelto por la función "getatt"). |
Valor devuelto
booleano
| Variable tipo booleano de TEIMSI que indica el resultado de la función. Si resulta "false" puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ver también <<
getatt>>
Volver arriba
seteof
La función "seteof", establece el final del archivo en la posición actual del puntero de escritura de un archivo. Dicho puntero se actualiza automáticamente al escribir datos en un archivo o al cambiarlo explícitamente mediante una llamada a la función "seek".
Sintaxis
Parámetros
manejador
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. |
Valor devuelto
booleano
| Variable tipo booleano de TEIMSI que indica el resultado de la función. Si resulta "false" puede usarse "err_number" y "err_description" para saber el error ocurrido. |
Ver también <<
openwrite>>, <<
seek>>
Volver arriba
write
La función "write", escribe datos en un archivo cuyo manejador (número entero) fue devuelto por alguna de las siguientes funciones: "openrand" o "openwrite".
Sintaxis
Parámetros
manejador
| Variable tipo número entero de 32 bits de TEIMSI. Contiene el manejador (o índice interno del sistema operativo) de un archivo. |
cadena
| Variable tipo cadena de TEIMSI. Es el bloque de bytes a escribir. |
Valor devuelto
Ejemplo:
(ver ejemplo de la función "closeh")
Ver también <<
read>>, <<
closeh>>
Volver arriba