%creat() Function

The %creat() function creates a new host OS file or prepares to rewrite an existing host OS file designated by str for write only.

Syntax

file.descriptor = %creat(str, mode)

Parameter(s)

str

Name of the file to create.

mode

Controls the file mode. Valid values of mode are in the include: mode.h. Combinations of the modes are obtained by adding several elementary modes together.


NOTE

On D3, files are closed automatically when the FlashBASIC program terminates.

Example(s)

include dm,bp,unix.h mode.h

* Create a local file named myfile

* read and write permissions

fd=%creat("myfile",s$iread+s$iwrite)

Note the usage of the + operator to combine flags, where a regular C program would have used an or.

See Also

%close() Function, %fsize() Function, %rdhex() Function, %read() Function, %unlink ()Function, %whex() Function, %write() Function, FlashBASIC C Functions Overview, cfunction Statement