PickBASIC / FlashBASIC

%fopen() function

The %fopen() function opens the host OS file designated by str and associates a stream with it.

Syntax

stream = (char*)%fopen(str, type)

Parameter(s)


`str`	Specifies the file to open.
`type`	Character string having one of these values:
	r	Opens for reading only.
	r+	Opens for update.
	w	Truncates or creates for writing only.
	w+	Truncates or creates for update.
	a	Append. Opens for writing at the end of file or creates for writing.
	a+	Append. Opens for writing at the end of file or creates for update.

Description

The stream is returned as a pointer to a character or 0 if an error occurred. system(0) contains the error number.

Note: In D3, files are closed automatically when the FlashBASIC programs terminate. However, it is strongly recommended that you close all descriptors explicitly.

Example(s)

stream=(char*)%fopen(’fname’,"w+")
if stream=0 then
   crt ’Cannot open stream. errno=’:system(0)
end

See also

%fclose() function→%fdopen() function→%fgetc() function→%fgets() function→%fprintf() function→%fputc() function→%freopen() function→FlashBASIC C functions overview→cfunction statement→