_fopen

#fopen

###Open a file.

Syntax

status = fopen ( filespec,mode ) ;

Arguments

1. str filespec

File name specification

2. str mode

File mode. One of "r", "r+", "w", "w+", "a", "a+".

Return Value

str status

• $ACKNOWLEDGE : The file was opened.

The STATUS variable is set to $ACKNOWLEDGE

str status

• $ACKNOWLEDGE : The file was opened.

The STATUS variable is set to $ACKNOWLEDGE

Exceptions

• %ARGUMENT: Invalid arguments. Usage: status = fopen ( filespec,mode ) ;

• %FILE: Failed to open file

Description

The file modes for fopen() are as follows:

• **"r" **Open text file for reading. The stream is positioned at the beginning of the file.
• **"r+" **Open for reading and writing. The stream is positioned at the beginning of the file.
• **"w" **Truncate file to zero length or create text file for writing. The stream is positioned at the beginning of the file.
• **"w+" **Open for reading and writing. The file is created if it does not exist, otherwise it is truncated. The stream is positioned at the beginning of the file.
• **"a" **Open for writing. The file is created if it does not exist. The stream is positioned at the end of the file.
• **"a+" **Open for reading and writing. The file is created if it does not exist. The stream is positioned at the end of the file.

Examples

puts "Create an example for the function 'fopen'" ;

Related Links

fclose