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

© 2001-2020 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.