NAME¶
IO::open - Open a file.
SYNOPSIS¶
File open( String fname, [FileMode] mode )
ARGUMENTS¶
fname The name of the file
mode A list of file modes
DESCRIPTION¶
Open the named file with the specified file modes. Not all combinations of modes
are legal, and an
IO.InvalidMode (3kaya) Exception will be thrown if an
illegal mode is selected. A
IO.FileError (3kaya) Exception will be
thrown if opening fails for any other reason. Legal mode combinations are:
-
- - [Read,Write] : read and write to any point in the file
-
- - [Read,Append] : read from any point in the file, write to the
end only (creating the file if it does not exist)
-
- - [Read] : read from any point in the file
-
- - [Write] : write to any point in the file, creating the file if
it does not exist, and truncating it otherwise.
-
- - [Append] : write to the end of the file, creating the file if it
doesn't exist.
Binary can be added to any of the combinations above to open the file in
binary mode on Windows (it has no effect on POSIX platforms).
AUTHORS¶
Kaya standard library by Edwin Brady, Chris Morris and others
(kaya@kayalang.org). For further information see
http://kayalang.org/
LICENSE¶
The Kaya standard library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public License (version
2.1 or any later version) as published by the Free Software Foundation.
IO.close (3kaya)
IO.reopen (3kaya)