Docs » Autodocs » dos.library » Open
Open -- Open a file for input or output
file = Open( name, accessMode )
D0 D1 D2
BPTR Open(STRPTR, LONG)
The named file is opened and a file handle returned. If the
accessMode is MODE_OLDFILE, an existing file is opened for reading
or writing. If the value is MODE_NEWFILE, a new file is created for
writing. MODE_READWRITE opens a file with an shared lock, but
creates it if it didn't exist. Open types are documented in the
<dos/dos.h> or <libraries/dos.h> include file.
The 'name' can be a filename (optionally prefaced by a device
name), a simple device such as NIL:, a window specification such as
CON: or RAW: followed by window parameters, or "*", representing the
current window. Note that as of V36, "*" is obsolete, and CONSOLE:
should be used instead.
If the file cannot be opened for any reason, the value returned
will be zero, and a secondary error code will be available by
calling the routine IoErr().
name - pointer to a null-terminated string
accessMode - integer
file - BCPL pointer to a file handle
Close(), ChangeMode(), NameFromFH(), ParentOfFH(), ExamineFH()
|
