ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
Call the close() method of the FileStream object when you are done working with the file.
Calling the close() method makes the file available to other applications.
For details, see “Initializing a FileStream object, and opening and closing files” on page 689.
To see a sample application that uses the FileStream class to read and write files, see the following articles at the Adobe
AIR Developer Center:
Building a text-file editor
Building a text-file editor
Reading and writing from an XML preferences file
Working with FileStream objects
Adobe AIR 1.0 and later
The FileStream class defines methods for opening, reading, and writing files.
FileStream open modes
Adobe AIR 1.0 and later
The open() and openAsync() methods of a FileStream object each include a fileMode parameter, which defines
some properties for a file stream, including the following:
The ability to read from the file
The ability to write to the file
Whether data will always be appended past the end of the file (when writing)
What to do when the file does not exist (and when its parent directories do not exist)
The following are the various file modes (which you can specify as the fileMode parameter of the open() and
openAsync() methods):
File mode Description
FileMode.READ Specifies that the file is open for reading only.
FileMode.WRITE Specifies that the file is open for writing. If the file does not exist, it is created when the FileStream object
is opened. If the file does exist, any existing data is deleted.
FileMode.APPEND Specifies that the file is open for appending. The file is created if it does not exist. If the file exists, existing
data is not overwritten, and all writing begins at the end of the file.
FileMode.UPDATE Specifies that the file is open for reading and writing. If the file does not exist, it is created. Specify this
mode for random read/write access to the file. You can read from any position in the file. When writing
to the file, only the bytes written overwrite existing bytes (all other bytes remain unchanged).
Initializing a FileStream object, and opening and closing files
Adobe AIR 1.0 and later
When you open a FileStream object, you make it available to read and write data to a file. You open a FileStream object
by passing a File object to the open() or openAsync() method of the FileStream object:
Last updated 6/6/2012
689