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.

RELATED

       IO.close (3kaya)
       IO.reopen (3kaya)

Kaya                                                July 2013                                     IO.open(3kaya)