Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: AIR 30.0 или более ранней версии, Flash Player 30.0 или более ранней версии, Flash Lite 4
Flex 4.6 или более ранней версии, Flash Pro CS6 или более ранней версии
Скрыть фильтры
flash.filesystem 

FileStream  - AS3

Пакетыx

Верхний уровень
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Элементы языка

Глобальные константы
Глобальные функции
Операторы
Инструкции, ключевые слова и директивы
Специальные типы

Приложения

Новые возможности
Ошибки компилятора
Предупреждения компилятора
Ошибки времени выполнения
Миграция ActionScript 3
Поддерживаемые наборы символов
Только MXML
Элементы движения XML
Теги Timed Text
устаревший_индекс
Константы реализации специальных возможностей
Использование примеров
Юридическая информация
Пакетflash.filesystem
Классpublic class FileStream
НаследованиеFileStream Inheritance EventDispatcher Inheritance Object
Реализует IDataInput, IDataOutput

Версии среды выполнения: AIR 1.0

Объект FileStream используется для чтения и записи файлов. Файлы можно открывать в синхронном режиме с помощью метода open() или в асинхронном с помощью метода openAsync().

Преимущество открытия файлов в асинхронном режиме состоит в том, что пока Adobe AIR выполняет чтение и запись в фоновом режиме, может исполняться и другой код. При открытии в асинхронном режиме события progress вызываются по мере выполнения операций.

Поведение объекта File, открываемого в асинхронном режиме, похоже на поведение объекта ByteArray, а поведение файла, открываемого в асинхронном режиме, похоже на поведение объекта Socket или URLStream. Когда объект File открывается в синхронном режиме, вызывающий оператор приостанавливает работу, пока запрошенные данные считываются или записываются в файл. Когда же он открывается в асинхронном режиме, все записываемые данные немедленно помещаются в буфер и записываются в файл позднее.

Независимо от того, в синхронном или асинхронном режиме выполняется чтение, в действительности методы чтения являются синхронными. В обоих случаях считывание производится из данных, которые «доступны» в текущий момент времени. Разница в том, что при синхронном чтении все данные доступны постоянно, а при асинхронном данные становятся доступны по мере того, как они передаются в буфер считывания. В любом случае, данные, которые в настоящий момент можно считать синхронным способом, представлены свойством bytesAvailable.

Приложение, обрабатывающее вводимые данные в асинхронном режиме, обычно ожидает событий progress и использует данные по мере того, как они становятся доступны, через вызов методов чтения. С другой стороны, приложение может просто дождаться, когда станут доступны все данные (событие complete), и как только событие complete будет выполнено, обработать все данные сразу.



Общедоступные свойства
 СвойствоОпределено
      bytesAvailable : uint
[только для чтения] Возвращает число байтов данных, доступных для чтения во входном буфере.
FileStream
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
      endian : String
Порядок байтов данных, константа BIG_ENDIAN или LITTLE_ENDIAN класса Endian.
FileStream
      objectEncoding : uint
Указывает, какой формат, AMF3 или AMF0, используется для записи или чтения бинарных данных методом readObject() или writeObject().
FileStream
      position : Number
Текущее положение в файле.
FileStream
      readAhead : Number
Минимальный объем данных, читаемых с диска в асинхронном режиме.
FileStream
Общедоступные методы
 МетодОпределено
  
    FileStream()
Создает объект FileStream.
FileStream
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
    close():void
Закрывает объект FileStream.
FileStream
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
    open(file:File, fileMode:String):void
Открывает объект FileStream в синхронном режиме, указывая на файл, заданный параметром file.
FileStream
  
    openAsync(file:File, fileMode:String):void
Открывает объект FileStream в асинхронном режиме, указывая на файл, заданный параметром file.
FileStream
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Считывает логическое значение из потока файлов, байтов или массива байтов.
FileStream
  
    readByte():int
Считывает байт со знаком из потока файлов, байтов или массива байтов.
FileStream
  
    readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Считывает число байтов данных, заданное параметром length, из потока файлов, байтов или массива байтов.
FileStream
  
    readDouble():Number
Считывает из потока файлов, байтов или массива байтов число IEEE 754 с двойной точностью и плавающей запятой.
FileStream
  
    readFloat():Number
Считывает из потока файлов, байтов или массива байтов число IEEE 754 с одинарной точностью и плавающей запятой.
FileStream
  
    readInt():int
Считывает из потока файлов, байтов или массива байтов 32-разрядное целое число со знаком.
FileStream
  
    readMultiByte(length:uint, charSet:String):String
Считывает из потока файлов, байтов или массива байтов многобайтовую строку заданной длины с использованием указанного набора символов.
FileStream
  
    readObject():*
Считывает объект из потока файлов, байтов или массива байтов зашифрованный в сериализованном формате AMF.
FileStream
  
    readShort():int
Считывает из потока файлов, байтов или массива байтов 16-разрядное целое число со знаком.
FileStream
  
Считывает байт без знака из потока файлов, байтов или массива байтов.
FileStream
  
Считывает из потока файлов, байтов или массива байтов 32-разрядное целое число без знака.
FileStream
  
Считывает из потока файлов, байтов или массива байтов 16-разрядное целое число без знака.
FileStream
  
    readUTF():String
Считывает из потока файлов, байтов или массива байтов строку UTF-8.
FileStream
  
    readUTFBytes(length:uint):String
Считывает последовательность байтов UTF-8 из потока байтов или массива байтов и возвращает строку.
FileStream
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
    truncate():void
Сокращает файл до положения, заданного свойством position объекта FileStream.
FileStream
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
  
    writeBoolean(value:Boolean):void
Записывает логическое значение.
FileStream
  
    writeByte(value:int):void
Записывает байт.
FileStream
  
    writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Записывает последовательность байтов из заданного массива байтов, начиная с байта, заданного параметром offset (используя индекс с нулевой базой), длиной, заданной параметром length, в поток файлов, байтов или массив байтов.
FileStream
  
    writeDouble(value:Number):void
Записывает число IEEE 754 с двойной точностью (64-разрядное) и плавающей запятой.
FileStream
  
    writeFloat(value:Number):void
Записывает число IEEE 754 с одинарной точностью (32-разрядное) и плавающей запятой.
FileStream
  
    writeInt(value:int):void
Записывает 32-разрядное целое число со знаком.
FileStream
  
    writeMultiByte(value:String, charSet:String):void
Записывает в поток файлов, байтов или массив байтов многобайтовую строку заданной длины с использованием заданного набора символов.
FileStream
  
    writeObject(object:*):void
Записывает объект в поток файлов, байтов или массив байтов в сериализованном формате AMF.
FileStream
  
    writeShort(value:int):void
Записывает 16-разрядное целое число.
FileStream
  
    writeUnsignedInt(value:uint):void
Записывает 32-разрядное целое число без знака.
FileStream
  
    writeUTF(value:String):void
Записывает в поток файлов, байтов или массив байтов строку UTF-8.
FileStream
  
    writeUTFBytes(value:String):void
Записывает строку UTF-8.
FileStream
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
  
    close
Указывает, что поток был закрыт формальным вызовом метода close().FileStream
  
    complete
Сообщает о достижении конца потока.FileStream
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
  
    ioError
Указывает, что во время выполнения асинхронной операции ввода-вывода произошла ошибка.FileStream
  Сообщает, что запись данных из буфера в файл завершена.FileStream
  
    progress
Сообщает, что в потоке появились новые доступные данные.FileStream
Сведения о свойстве
    

bytesAvailable

свойство
bytesAvailable:uint  [только для чтения]

Версии среды выполнения: AIR 1.0

Возвращает число байтов данных, доступных для чтения во входном буфере. В коде должен быть вызов свойства bytesAvailable, проверяющий доступность необходимого объема данных до того, как будет выполнена попытка их считывания с помощью одного из методов чтения.



Реализация
    public function get bytesAvailable():uint
    

endian

свойство 
endian:String

Версии среды выполнения: AIR 1.0

Порядок байтов данных, константа BIG_ENDIAN или LITTLE_ENDIAN класса Endian.



Реализация
    public function get endian():String
    public function set endian(value:String):void
    

objectEncoding

свойство 
objectEncoding:uint

Версии среды выполнения: AIR 1.0

Указывает, какой формат, AMF3 или AMF0, используется для записи или чтения бинарных данных методом readObject() или writeObject().

Значение представлено константой из класса ObjectEncoding. По умолчанию используется формат AMF3.



Реализация
    public function get objectEncoding():uint
    public function set objectEncoding(value:uint):void

Связанные элементы API

    

position

свойство 
position:Number

Версии среды выполнения: AIR 1.0

Текущее положение в файле.

Данное значение изменяется при следующих условиях:

  • Если явно задано свойство.
  • Если производится считывание из объекта FileStream (с использованием одного из методов чтения).
  • Если производится запись в объект FileStream.

Положение определяется как Number (а не uint) для поддержки файлов длиной более 232 байтов. Значение данного свойства всегда представлено целым числом до 253. Если задать это значение дробным числом, то оно будет округлено до целого в меньшую сторону.

Если при асинхронном чтении файла задать свойство position, приложение начнет заполнять буфер чтения данными, начиная с указанного положения, а свойство bytesAvailable может принять значение 0. Дождитесь события complete, прежде чем использовать метод read для чтения данных или дождитесь события progress и проверьте свойство bytesAvailable, прежде чем использовать метод read.



Реализация
    public function get position():Number
    public function set position(value:Number):void

Пример  ( Использование этого примера )
На примере следующего кода показано, как обновляется свойство position объекта FileStream по мере считывания приложением данных из файла.
import flash.fileSystem.*;
import flash.utils.ByteArray;
import flash.events.Event;

var sourceFile:File = File.documentsDirectory.resolvePath("Apollo Test/test.txt");
var stream:FileStream = new FileStream();
stream.addEventListener(Event.COMPLETE, readBytes);
stream.openAsync(sourceFile, FileMode.READ);

function readBytes(e:Event):void {
    var bytes:ByteArray = new ByteArray();
    trace("position 0:", stream.position); // 0
    bytes[0] = stream.readByte();
    trace("position 1:", stream.position); // 1
    fileStream.readBytes(bytes, stream.position, 4); 
    trace("position 2:", stream.position); // 5
    stream.close();
}
    

readAhead

свойство 
readAhead:Number

Версии среды выполнения: AIR 1.0

Минимальный объем данных, читаемых с диска в асинхронном режиме.

Это свойство указывает, сколько данных пытается считать асинхронный поток за точкой текущего положения. Данные считываются блоками на основе размера страницы файловой системы. Поэтому, если для readAhead установлено значение 9000 в компьютерной системе с размером страницы 8 КБ (8192 байт), среда выполнения одновременно считывает следующие 2 блока или 16384 байт данных. Значение этого свойства по умолчанию — бесконечность: по умолчанию из файла, открытого для асинхронного чтения, данные считываются, пока не будет достигнут конец файла.

Считывание данных из буфера чтения не влияет на значение свойства readAhead. При считывании данных из буфера новые данные считываются в буфер для его пополнения.

Свойство readAhead не влияет на файл, открытый в синхронном режиме.

При считывании данных в асинхронном режиме объект FileStream отправляет события progress. В методе обработчика событий для события progress проверьте доступность необходимого количества байтов (это можно проверить с помощью свойства bytesAvailable), а затем считайте данные из буфера чтения с помощью метода read.



Реализация
    public function get readAhead():Number
    public function set readAhead(value:Number):void

Пример  ( Использование этого примера )
На примере следующего кода показано, как с помощью свойства readAhead ограничить объем данных, считываемых в файл, до 100 байтов:
import flash.filesystem.*;

var file:File = File.desktopDirectory.resolvePath("test.txt");
var fileStream:FileStream = new FileStream();
fileStream.readAhead = 100;
fileStream.addEventListener(ProgressEvent.PROGRESS, readProgressHandler)
fileStream.openAsync(file, FileMode.READ);
var results:ByteArray;

function readProgressHandler(event:ProgressEvent):void {
    if (fileStream.bytesAvailable >= 100) {
        fileStream.readBytes(results, 0, 100);
    }
}
Сведения о конструкторе
    

FileStream

()Конструктор
public function FileStream()

Версии среды выполнения: AIR 1.0

Создает объект FileStream. Для открытия файла используйте методы open() или openAsync().

Связанные элементы API

Сведения о методе

    close

()метод
public function close():void

Версии среды выполнения: AIR 1.0

Закрывает объект FileStream.

После вызова метода close() данные невозможно считывать или записывать. Если файл был открыт в асинхронном режиме (объект FileStream использует для открытия файла метод openAsync()), вызов метода close() заставляет объект вызвать событие close.

Автоматическое закрытие приложения закрывает все файлы, связанные с объектами FileStream в приложении. Тем не менее, рекомендуется ставить все асинхронно открытые объекты FileStream, у которых есть данные, ожидающие записи, в очередь на событие closed, прежде чем закрывать приложение (чтобы данные точно были записаны).

Можно повторно использовать объект FileStream, вызвав метод open() или openAsync(). Все файлы, связанные с объектом FileStream, при этом закрываются, но объект не вызывает событие close.

Что касается объекта FileStream, открытого в асинхронном режиме (с использованием метода openAsync()), то даже если вызвать событие close() для этого объекта и удалить свойства и переменные, ссылающиеся на него, объект FileStream не будет удален из памяти до тех пор, пока в остаются невыполненные операции и обработчики событий, ждущие их выполнения. В частности, объект FileStream, на который нет других ссылок, будет существовать, пока выполняется хотя бы одно из следующих условий:

  • При выполнении считывания из файла не был достигнут конец файла (и не было вызвано событие complete).
  • Выходные данные будут по-прежнему доступны для записи, а у связанных с ними событий (таких как outputProgress или ioError) будут прослушиватели событий.


События
close:Event — Открытый в асинхронном режиме файл будет закрыт.

Связанные элементы API


Пример  ( Использование этого примера )

Следующий код открывает объект FileStream асинхронно и записывает текстовый файл с именем test.txt во вложенный каталог Apollo Test каталога документов пользователя. Вызов метода close() объекта FileStream закрывает файл после записи данных.
import flash.filesystem.*;
import flash.events.Event;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.WRITE);
fileStream.writeUTFBytes("Hello");
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();

function fileClosed(event:Event):void {
    trace("closed");
}            

Следующий код открывает объект FileStream синхронно и записывает текстовый файл с именем test.txt во вложенный каталог Apollo Test каталога документов пользователя. Вызов метода close() объекта FileStream закрывает файл после записи данных.
import flash.filesystem.*;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.WRITE);
fileStream.writeUTF("Hello");
fileStream.close();

    open

()метод 
public function open(file:File, fileMode:String):void

Версии среды выполнения: AIR 1.0

Открывает объект FileStream в синхронном режиме, указывая на файл, заданный параметром file.

Если объект FileStream уже открыт, вызов метода закрывает файл перед открытием, и последующие события (включая close) не передаются ранее открытому файлу.

В системах, поддерживающих блокирование файлов, файлы, открытые только для записи или только для обновления (FileMode.WRITE или FileMode.UPDATE), недоступны для чтения, пока они не будут закрыты.

После завершения выполнения операций с файлом необходимо вызвать метод close() объекта FileStream. В некоторых системах число одновременно открытых файлов ограничено.

Параметры

file:File — Объект File, указывающий на файл, который необходимо открыть.
 
fileMode:String — Строка класса FileMode, определяющая доступные действия объекта FileStream, например чтение или запись в файл.


Выдает
IOError — Файла не существует; у вас нет прав для открытия файла; вы открываете файл для чтения, но у вас нет прав на чтение; вы открываете файл для записи, но у вас нет прав для записи.
 
SecurityError — Файл находится в каталоге приложения, и для параметра fileMode задан режим append, update или write.

Связанные элементы API


Пример  ( Использование этого примера )

Следующий код показывает, как синхронно открыть файл test.txt во вложенном каталоге Apollo Test каталога документов пользователя, а затем считать этот файл в строку, используя для кодировки текста системный набор символов.
import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.READ);
var str:String = fileStream.readMultiByte(file.size, File.systemCharset);
trace(str);
fileStream.close();

    openAsync

()метод 
public function openAsync(file:File, fileMode:String):void

Версии среды выполнения: AIR 1.0

Открывает объект FileStream в асинхронном режиме, указывая на файл, заданный параметром file.

Если объект FileStream уже открыт, вызов метода закрывает файл перед открытием, и последующие события (включая close) не передаются ранее открытому файлу.

Если параметру fileMode присвоена константа FileMode.READ или FileMode.UPDATE, AIR считывает данные во входной буфер при открытии файла, а события progress и open отправляются по мере считывания данных во входной буфер.

В системах, поддерживающих блокирование файлов, файлы, открытые только для записи или только для обновления (FileMode.WRITE или FileMode.UPDATE), недоступны для чтения, пока они не будут закрыты.

После завершения выполнения операций с файлом необходимо вызвать метод close() объекта FileStream. В некоторых системах число одновременно открытых файлов ограничено.

Параметры

file:File — Объект File, указывающий на файл, который необходимо открыть.
 
fileMode:String — Строка класса FileMode, определяющая доступные действия объекта FileStream, например чтение или запись в файл.


События
ioError:IOErrorEvent — Файла не существует; у вас нет прав для открытия файла; вы открываете файл для чтения, но у вас нет прав на чтение; вы открываете файл для записи, но у вас нет прав для записи.
 
progress:ProgressEvent — Вызывается при считывании данных во входной буфер. (При открытии файла для параметра fileMode должно быть установлено значение FileMode.READ или FileMode.UPDATE.)
 
complete:Event — Данные файла считаны во входной буфер. (При открытии файла для параметра fileMode должно быть установлено значение FileMode.READ или FileMode.UPDATE.)

Выдает
SecurityError — Файл находится в каталоге приложения, и для параметра fileMode задан режим append, update или write.

Связанные элементы API


Пример  ( Использование этого примера )

Следующий код показывает, как синхронно открыть файл test.txt во вложенном каталоге Apollo Test каталога документов пользователя, а затем считать этот файл в строку, используя для кодировки текста системный набор символов.
import flash.filesystem.*;
import flash.events.Event;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.addEventListener(Event.COMPLETE, fileCompleteHandler)
fileStream.openAsync(file, FileMode.READ);

function fileCompleteHandler(event:Event):void {
    var str:String = fileStream.readMultiByte(fileStream.bytesAvailable, File.systemCharset);
    trace(str);
    fileStream.close();
}

    readBoolean

()метод 
public function readBoolean():Boolean

Версии среды выполнения: AIR 1.0

Считывает логическое значение из потока файлов, байтов или массива байтов. Считывается один байт. Если этот байт ненулевой, то возвращается значение true. В противном случае возвращается значение false.

Возвращает
Boolean — Логическое значение будет true, если количество байтов не равно нулю, в остальных случаях оно будет false.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readByte

()метод 
public function readByte():int

Версии среды выполнения: AIR 1.0

Считывает байт со знаком из потока файлов, байтов или массива байтов.

Возвращает
int — Возвращенное значение находится в диапазоне от -128 до 127.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readBytes

()метод 
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Версии среды выполнения: AIR 1.0

Считывает число байтов данных, заданное параметром length, из потока файлов, байтов или массива байтов. Байты считываются в объект ByteArray, определяемый параметром bytes, при этом начальная позиция определяется параметром offset.

Параметры

bytes:ByteArray — Объект ByteArray, в который считываются данные.
 
offset:uint (default = 0) — Смещение в параметре bytes, с которого должно начинаться считывание данных.
 
length:uint (default = 0) — Число байтов для считывания. Если значение по умолчанию равно 0, считываются все доступные данные.


События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readDouble

()метод 
public function readDouble():Number

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов число IEEE 754 с двойной точностью и плавающей запятой.

Возвращает
Number — Число IEEE 754 с двойной точностью и плавающей запятой.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readFloat

()метод 
public function readFloat():Number

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов число IEEE 754 с одинарной точностью и плавающей запятой.

Возвращает
Number — Число IEEE 754 с одинарной точностью и плавающей запятой.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readInt

()метод 
public function readInt():int

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов 32-разрядное целое число со знаком.

Возвращает
int — Возвращаемое значение находится в диапазоне от -2147483648 до 2147483647.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readMultiByte

()метод 
public function readMultiByte(length:uint, charSet:String):String

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов многобайтовую строку заданной длины с использованием указанного набора символов.

Параметры

length:uint — Число считываемых из потока байтов.
 
charSet:String — Строка, обозначающая набор символов, которые используются для интерпретации байтов. Возможные строки наборов символов: "shift_jis", "cn-gb", "iso-8859-1" и другие. Полный список см. в разделе Поддерживаемые наборы символов.

Примечание. Если в текущей системе не распознается значение параметра charSet, то в качестве набора символов Adobe® Flash® Player или Adobe® AIR® будет использована кодовая страница по умолчанию. Например, значение параметра charSet, как в myTest.readMultiByte(22, iso-8859-01), использующее 01 вместо 1, может работать в системе разработчика, а в другой системе нет. В другой системе программа Flash Player или среда выполнения AIR будет использовать кодовую страницу, заданную по умолчанию в системе.

Возвращает
String — Строка в кодировке UTF-8.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

Связанные элементы API

    readObject

()метод 
public function readObject():*

Версии среды выполнения: AIR 1.0

Считывает объект из потока файлов, байтов или массива байтов зашифрованный в сериализованном формате AMF.

Возвращает
* — Десериализованный объект

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

Связанные элементы API

    readShort

()метод 
public function readShort():int

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов 16-разрядное целое число со знаком.

Возвращает
int — Возвращаемое значение находится в диапазоне от -32768 до 32767.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readUnsignedByte

()метод 
public function readUnsignedByte():uint

Версии среды выполнения: AIR 1.0

Считывает байт без знака из потока файлов, байтов или массива байтов.

Возвращает
uint — Возвращенное значение находится в диапазоне от 0 до 255.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readUnsignedInt

()метод 
public function readUnsignedInt():uint

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов 32-разрядное целое число без знака.

Возвращает
uint — Возвращенное значение находится в диапазоне от 0 до 4294967295.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readUnsignedShort

()метод 
public function readUnsignedShort():uint

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов 16-разрядное целое число без знака.

Возвращает
uint — Возвращенное значение находится в диапазоне от 0 до 65535.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readUTF

()метод 
public function readUTF():String

Версии среды выполнения: AIR 1.0

Считывает из потока файлов, байтов или массива байтов строку UTF-8. Предполагается, что в строку вставляется префикс с неподписанным значением, указывающим длину в байтах.

Этот метод похож на метод readUTF() в интерфейсе Java® IDataInput.

Возвращает
String — Строка в кодировке UTF-8, являющаяся байтовым представлением символов.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    readUTFBytes

()метод 
public function readUTFBytes(length:uint):String

Версии среды выполнения: AIR 1.0

Считывает последовательность байтов UTF-8 из потока байтов или массива байтов и возвращает строку.

Параметры

length:uint — Число байтов для считывания.

Возвращает
String — Строка в кодировке UTF-8, являющаяся байтовым представлением символов указанной длины.

События
ioError:IOErrorEvent — Чтение файла невозможно или файл не открыт. Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на чтение; либо, если файл был открыт для синхронных операций (с помощью метода open()), файл не может быть считан (например, из-за отсутствия файла).
 
EOFError — Положение, определенное для считывания данных, превышает количество доступных байтов (задается свойством bytesAvailable).

    truncate

()метод 
public function truncate():void

Версии среды выполнения: AIR 1.0

Сокращает файл до положения, заданного свойством position объекта FileStream.

Все байты от положения, заданного свойством position, до конца файла, удаляются. Файл должен быть открыт для записи.


Выдает
IllegalOperationError — Файл не открыт для записи.

Связанные элементы API


Пример  ( Использование этого примера )

Следующий код синхронно открывает файл test.txt во вложенном каталоге Apollo Test каталога документов пользователя, а затем обрезает этот файл до 100 символов, если его длина превышает 100 символов.
import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.UPDATE);
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.close();

Следующий код асинхронно открывает файл test.txt во вложенном каталоге Apollo Test каталога документов пользователя, а затем обрезает этот файл до 100 символов, если его длина превышает 100 символов.
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.UPDATE);
trace("start", file.size)
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();
function fileClosed(event:Event):void {
    trace("closed", file.size); 
}

    writeBoolean

()метод 
public function writeBoolean(value:Boolean):void

Версии среды выполнения: AIR 1.0

Записывает логическое значение. Записывается один байт, соответствующий параметру value, 1 в случае значения true и 0 в случае значения false.

Параметры

value:Boolean — Логическое значение, показывающее, какой байт записывается. Если параметр имеет значение true, записывается 1; если false, записывается 0.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeByte

()метод 
public function writeByte(value:int):void

Версии среды выполнения: AIR 1.0

Записывает байт. Используются 8 младших битов параметра, а 24 старших битов игнорируются.

Параметры

value:int — Значение байта в виде целого числа.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeBytes

()метод 
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Версии среды выполнения: AIR 1.0

Записывает последовательность байтов из заданного массива байтов bytes, начиная с байта, заданного параметром offset (используя индекс с нулевой базой), длиной, заданной параметром length, в поток файлов, байтов или массив байтов.

Если параметр length опущен, применение длины по умолчанию, равной 0, приведет к тому, что будет записан весь буфер, начиная со значения параметра offset. Если также опустить параметр offset, будет записываться весь буфер.

Если параметры offset или length находятся за пределами диапазона, то они корректируются так, чтобы совпасть с началом и концом массива bytes.

Параметры

bytes:ByteArray — Массив байтов для записи.
 
offset:uint (default = 0) — Индекс с нулевой базой, определяющий положение в массиве для начала записи.
 
length:uint (default = 0) — Целое число без знака, определяющее глубину буфера для записи.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeDouble

()метод 
public function writeDouble(value:Number):void

Версии среды выполнения: AIR 1.0

Записывает число IEEE 754 с двойной точностью (64-разрядное) и плавающей запятой.

Параметры

value:Number — Число с двойной точностью (64-разрядное) и плавающей запятой.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeFloat

()метод 
public function writeFloat(value:Number):void

Версии среды выполнения: AIR 1.0

Записывает число IEEE 754 с одинарной точностью (32-разрядное) и плавающей запятой.

Параметры

value:Number — Число с одинарной точностью (32-разрядное) и плавающей запятой.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeInt

()метод 
public function writeInt(value:int):void

Версии среды выполнения: AIR 1.0

Записывает 32-разрядное целое число со знаком.

Параметры

value:int — Значение байта в виде целого числа со знаком.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeMultiByte

()метод 
public function writeMultiByte(value:String, charSet:String):void

Версии среды выполнения: AIR 1.0

Записывает в поток файлов, байтов или массив байтов многобайтовую строку заданной длины с использованием заданного набора символов.

Параметры

value:String — Записываемое значение строки.
 
charSet:String — Строка, определяющая используемый набор символов. Возможные строки наборов символов: "shift_jis", "cn-gb", "iso-8859-1" и другие. Полный список см. в разделе Поддерживаемые наборы символов.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

Связанные элементы API

    writeObject

()метод 
public function writeObject(object:*):void

Версии среды выполнения: AIR 1.0

Записывает объект в поток файлов, байтов или массив байтов в сериализованном формате AMF.

Параметры

object:* — Объект для сериализации.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

Связанные элементы API

    writeShort

()метод 
public function writeShort(value:int):void

Версии среды выполнения: AIR 1.0

Записывает 16-разрядное целое число. Используются 16 младших битов параметра, а 16 старших битов игнорируются.

Параметры

value:int — Значение байта в виде целого числа.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeUnsignedInt

()метод 
public function writeUnsignedInt(value:uint):void

Версии среды выполнения: AIR 1.0

Записывает 32-разрядное целое число без знака.

Параметры

value:uint — Значение байта в виде целого числа без знака.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeUTF

()метод 
public function writeUTF(value:String):void

Версии среды выполнения: AIR 1.0

Записывает в поток файлов, байтов или массив байтов строку UTF-8. Сначала записывается длина строки UTF-8 в байтах (в виде 16-разрядного целого числа), за которой следуют байты символов строки.

Параметры

value:String — Записываемое значение строки.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
RangeError — Если длина строки превышает 65535.
 
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).

    writeUTFBytes

()метод 
public function writeUTFBytes(value:String):void

Версии среды выполнения: AIR 1.0

Записывает строку UTF-8. Аналогично writeUTF(), но строке не предшествует 16-разрядное слово, указывающее длину.

Параметры

value:String — Записываемое значение строки.


События
ioError:IOErrorEvent — Вы не можете произвести запись в файл (например, потому что файл отсутствует). Данное событие вызывается только для файлов, открытых для асинхронных операций (с помощью метода openAsync()).

Выдает
IOError — Файл не был открыт; файл был открыт, но без прав на запись; либо, если файл был открыт для синхронных операций (с помощью метода open()), в файл не может быть произведена запись (например, из-за отсутствия файла).
Сведения о событии
    

close

Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CLOSE

Версии среды выполнения: AIR 1.0

Указывает, что поток был закрыт формальным вызовом метода close().

Константа Event.CLOSE определяет значение свойства type объекта события close.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, для которого разорвано подключение.

Связанные элементы API

    

complete

Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.COMPLETE

Версии среды выполнения: AIR 1.0

Сообщает о достижении конца потока.

Константа Event.COMPLETE определяет значение свойства type объекта complete.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, который завершил загрузку.

Связанные элементы API

    

ioError

Событие  
Тип объекта события: flash.events.IOErrorEvent
свойство IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Версии среды выполнения: AIR 1.0

Указывает, что во время выполнения асинхронной операции ввода-вывода произошла ошибка.

Задает значение свойства type для объекта события ioError.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
errorIDСсылочный номер, связываемый с конкретной ошибкой (только AIR).
targetСетевой объект, с которым произошла ошибка ввода/вывода.
textТекст, отображаемый в качестве сообщения об ошибке.
    

outputProgress

Событие  
Тип объекта события: flash.events.OutputProgressEvent
свойство OutputProgressEvent.type = flash.events.OutputProgressEvent.OUTPUT_PROGRESS

Версии среды выполнения: AIR 1.0

Сообщает, что запись данных из буфера в файл завершена.

Задает значение свойства type для объекта события outputProgress.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
bytesPendingЧисло байт, которые остается записать на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байт, которые в итоге будут записаны в случае успешного завершения записи.
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект FileStream, сообщающий сведения о прогрессе.
    

progress

Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Версии среды выполнения: AIR 1.0

Сообщает, что в потоке появились новые доступные данные.

Задает значение свойства type для объекта события progress.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
bytesLoadedЧисло элементов или байтов, загруженных на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки.
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, сообщающий сведения о прогрессе.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.