TEIMSI
Plataforma del desarrollador de textos programados
Inicio|Utilidades|Foro|Documentación

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
binary_read(cadena)
 

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
closeh(manejador)
 

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
deletefile(senda)
 

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
fileexists(senda)
 

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
filesize(senda)
 

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
getatt(senda)
 

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
openrand(senda)
 

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
openread(senda)
 

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
openwrite(senda)
 

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
read(manejador,cantidad)
 

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
booleano
Si ocurrió un error devuelve "false" y puede usarse "err_number" y "err_description" para saber el error ocurrido.
 

Ejemplo:


	(ver ejemplo de la función "openrand")



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 ejemplo de la función "openrand")


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
setatt(senda, atributos)
 

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
seteof(manejador)
 

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
write(manejador,cadena)
 

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
booleano
Si ocurrió un error devuelve "false" y puede usarse "err_number" y "err_description" para saber el error ocurrido.
 

Ejemplo:


	(ver ejemplo de la función "closeh")


Ver también <<read>>, <<closeh>>


Volver arriba