file.open.pointer

Syntax

f = file.open.pointer(s,irw,im)

Open a file for reading/writing. A file pointer is returned, allowing for one to have multiple files open simultaneously. The file pointer may be passed to the file.read, file.write, and file.close functions. The file may be opened in a state to read/write/append information and may either be in FISH, ASCII, or binary mode.

Returns:

f - file pointer

Arguments:

s - file name

irw - Read/write mode identifier with the following values:

• 0: read access: file must exist
• 1: write access: existing file will be overwritten
• 2: write access: existing file will be appended

im - Type mode identifier with the following values:

• 0: FISH mode: read/write FISH variables. Only the data corresponding to the FISH variable, not the name of the variable, are read/written.
• 1: ASCII mode: read/write ASCII data. In a read operation, the data must be organized in lines, with CR/LF between lines.
• 2: Binary mode: read/write binary data.