fopen

Open a file.

Syntax

status = fopen ( filespec , mode ) ;

Arguments

str filespec

• File name specification

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

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

To execute the example below, press or modify the example to try different variations.
puts "Create an example for the function 'fopen'" ;

Related Links

fclose