Table of contents -> Chapter 12 - Functions for files

The next topic is the description for the use of the following predefined TEIMSI functions:

1)- binary_read(path)

2)- binary_write(path,string)

3)- closeh(handle)

4)- deletefile(path)

5)- fileexists(path)

6)- filesize(path)

7)- getatt(path)

8)- openrand(path)

9)- openread(path)

10)- openwrite(path)

11)- read(handle,amount)

12)- seek(handle,position)

13)- setatt(path,value)

14)- seteof(handle)

15)- write(handle,string)

binary_read

The "binary_read" function reads all the content of a file loading it into a TEIMSI variable with a data type of string.

	var string=binary_read("file.txt")
	alert("Is there a file ?, Answer = " + (string!=false))
	alert(string)

binary_write

The "binary_write" function write (overrides if already exists) into a file all the content of a string variable.

	var filename="file.txt"

	if(binary_write(filename, "Square root of 77= "+sqrt(77))){
		openapp(filename)
	}else{
		alert("Error "+err_number()+_nl+err_description(err_number()))
	}

closeh

The "closeh" function closes a file whose handler (integer) was returned by any of the following functions: openrand, openread, openwrite.

	var filename="file.txt"
	var handle=openwrite(filename)
	if(handle==false){
		alert("Error "+err_number()+_nl+err_description(err_number()))
		sys.quit()
	}
	write(handle,"Data.")
	closeh(handle)

deletefile

The "deletefile" function deletes a file in the file system.

fileexists

The "fileexists" function determines whether a file or directory exists.

	alert(fileexists("c:\\ "))

filesize

The "filesize" function returns the size of a file in a integer variable or double precision, or -1 if doesn't exists. If the size exceeds 2147483647 bytes the value returned is a double precision number rather than an integer.

getatt

The "getatt" function load the attributes of a file into an integer with certain bits activated according to the attributes (read, hidden, directory, etc.).

	var filename="file.txt"

	var result=getatt(filename)

	if(result===false){
		alert("Error "+err_number()+_nl+err_description(err_number()))
	}else{
		alert("The file " + filename + ", has an attribute of read-only = " + ((result & _att_readonly) != 0) );
	}

openrand

The "openrand" function opens a file for random access (read or write).

	var filename="file.txt"
	var result1=binary_write(filename, "abcdefghij")

	if(result1){
		var handle=openrand(filename)
	}
	if((result1==false) || (handle==false)){
		alert("Error "+err_number()+_nl+err_description(err_number()))
		sys.quit()
	}
		seek(handle,3)
		var letter=read(handle,1)
		closeh(handle)

	alert("Readen letter = "+letter)		// Shows the letter "d"

openread

The "openread" function opens a file for read access.

openwrite

The "openwrite" function opens a file for write access.

read

The "read" function reads data from a file whose handler (integer) was returned by any of the following functions: "openrand" or "openread".

	(see the example of the "openrand" function)

seek

The "seek" function moves the pointer read/write to a file whose handler (integer) was returned by any of the following functions: openrand, openread, openwrite.

	(see the example of the "openrand" function)

setatt

The "setatt" function sets the attributes of a file using an integer with certain activated according to the same attributes (read, hidden, directory, etc.) bits.

seteof

The "seteof" function sets the end of the file under the current position of the pointer for writing a file. This pointer is automatically updated when writing data to a file or changed by calling the "seek" function explicitly.

write

The "write" function writes data to a file whose handler (integer) was returned by any of the following functions: "openrand" or "openwrite".

	(see the example of the "closeh" function)