Support temporary file

Official web site : http://www.scolring.org/.

Plateform : Windows XP or +, GNU / Linux with glib > 2.x

Scol : 4.0 or +

Features

Open, close, read and write to the temporary file

Compilation

No specific way.

Scol api

List of functions

FileTemp : Scol type
_FILEOpenTemp : fun [Chn] FileTemp - Open a new temporary file
_FILECloseTemp : fun [FileTemp] I - Close a temporary file
_FILEReadTemp : fun [FileTemp I] S - Read a part of a temporary file
_FILESizeTemp : fun [Filetemp] I - Get the size of a temporary file
_FILETellTemp : fun [FileTemp] I - Get the position of the cursor in a temporary file
_FILESeekTemp : fun [FileTemp I I] I - Move the cursor to the temporary file
_FILEWriteTmp : fun [FileTemp S] I - Write to the temporary file

FileTemp

FileTemp is a new type

It describes a new temporary file.

_FILEOpenTemp

_FILEOpenTemp is a function to open a new temporary file.
This function opens a unique temporary file in binary read/write mode. The file will be automatically deleted when it is closed or the program terminates.

Prototype

Prototype : _FILEOpenTemp
Return	Type	Name	Description
fun [Chn] FileTemp
-	Chn	channel	a channel in which the connection will be created
FileTemp	-	-	New scol object, or nil if error (open the log to see the error returned)

Example

Open a new temporary file, save to any datas and read it.

typeof ftmp = FileTemp;;
typeof s = S;;

fun main()=
	_showconsole;

	set ftmp = _FILEOpenTemp _channel;

	_FILEWriteTmp ftmp "Scol  a good language !";
	_FILESeekTemp ftmp 5 0;
	_FILEWriteTmp ftmp "is";
	_FILESeekTemp ftmp 0 0;
	set s = _FILEReadTemp ftmp 25;
	_fooS strcat "Temp : " s;

	_FILECloseTemp ftmp;
	0;;

_FILECloseTemp

Destroy a temporary file Scol object. The physical file will be automatically deleted.

Prototype

Prototype : _FILECloseTemp
Return	Type	Name	Description
fun [FileTemp] I
-	FileTemp	file	any temporary file Scol object already created.
I	-	-	0, or nil if error

_FILEReadTemp

Read to a number of bytes of a temporary file from the curent position of its cursor.

Prototype

Prototype : _FILEReadTemp
Return	Type	Name	Description
fun [FileTemp I] S
-	FileTemp	file	any temporary file Scol object already created.
-	I	bytes	the number of bytes to read.
S	-	-	the string read or nil if error

_FILESizeTemp

Return the size of a temporary file.

Prototype

Prototype : _FILESizeTemp
Return	Type	Name	Description
fun [FileTemp] S
-	FileTemp	file	any temporary file Scol object already created.
I	-	-	its size or nil if error

_FILETellTemp

Return the current cursor's position of a temporary file.

Prototype

Prototype : _FILETellTemp
Return	Type	Name	Description
fun [FileTemp] S
-	FileTemp	file	any temporary file Scol object already created.
I	-	-	its position or nil if error

_FILESeekTemp

Move the cursor to a temporary file.

Prototype

Prototype : _FILESeekTemp
Return	Type	Name	Description
fun [FileTemp I I] S
-	FileTemp	file	any temporary file Scol object already created.
-	I	bytes	the number of bytes to move.
-	I	from	This flag can take 3 values : 0 : le cursor will be moved to _bytes_ bytes from the begin of the file (default) 1 : le cursor will be moved to _bytes_ bytes from its current position 2 : le cursor will be moved to _bytes_ bytes from the end of the file
I	-	-	0 or nil if error

_FILEWriteTmp

Write a string to a temporary file from the current position of its cursor.
If needed, move the cursor (_FILESeekTemp) before to write it.

Prototype

Prototype : _FILEWriteTmp
Return	Type	Name	Description
fun [FileTemp S] I
-	FileTemp	file	any temporary file Scol object already created.
-	S	bytes	the string to write.
I	-	-	0 or nil if error