Initializing help system before first use

fopen

fopen

Purpose
Open a file and select it as the current input/output/error stream.
Synopsis
int fopen(XPRMcontext ctx, int flag, const char *fname);
Arguments
ctx 
Mosel's execution context
flag 
Open mode (may be combined). Possible values are
XPRM_F_READ 
Open for reading
XPRM_F_WRITE 
Open for writing (reset the file)
XPRM_F_ERROR 
Open for writing an error stream (reset the file)
XPRM_F_APPEND 
Open for writing (append)
XPRM_F_BINARY 
Open in binary mode (default is text mode)
XPRM_F_LINBUF 
If open for writing, flushes buffer after end of each line (default when writing to a console or for an error stream)
XPRM_F_SILENT 
Do not display IO error messages
XPRM_F_DELCLOSE 
Delete the file after the stream has been closed
fname 
Name of the file to open
Return value
The stream number or a negative value in case of error.
Further information
1. This function opens a file and assigns the resulting stream to the current input stream (file open for reading), to the current output stream (file open for writing) or error stream (flag XPRM_F_ERROR used). The value returned can be used as input for function fselect.
2. The binary mode is only effective under the Windows operating system. Its main effect is to disable the conversion of the \n character into the sequence \r\n when outputting text strings.
Related topics
fclose, normfname.

Parent Topic Input and output