Naslaggids voor Adobe ActionScript® 3.0 voor het Adobe® Flash®-platform
Startpagina  |  Lijst met pakketten en klassen verbergen |  Pakketten  |  Klassen  |  Nieuw  |  Index  |  Bijlagen  |  Waarom in het Engels?
Filters: AIR 30.0 en eerder, Flash Player 30.0 en eerder, Flash Lite 4
Flex 4.6 en eerder, Flash Pro CS6 en eerder
Filters verbergen
flash.utils 

ByteArray  - AS3

Pakkettenx

Hoofdniveau
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

Taalelementen

Algemene constanten
Algemene functies
Operatoren
Programmeerinstructies, gereserveerde woorden en compileraanwijzingen
Speciale typen

Bijlagen

Nieuw
Compilerfouten
Compilerwaarschuwingen
Uitvoeringsfouten
Migreren naar ActionScript 3
Ondersteunde tekensets
Alleen MXML-labels
Elementen van bewegings-XML
Timed Text-tags
Lijst van vervangen elementen
Constanten voor toegankelijkheidsimplementatie
ActionScript-voorbeelden gebruiken
Juridische kennisgeving
Pakketflash.utils
Klassepublic class ByteArray
OverervingByteArray Inheritance Object
Implementatie IDataInput, IDataOutput
Subklassen ByteArrayAsset

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De klasse ByteArray biedt methoden en eigenschappen voor het optimaliseren van het lezen van, schrijven van en werken met binaire gegevens.

Opmerking: de klasse ByteArray is bedoeld voor gevorderde ontwikkelaars die op byteniveau toegang tot gegevens nodig hebben.

Gegevens in het geheugen vormen een gecomprimeerde array (de meest compacte representatie van het gegevenstype) van bytes, maar een instantie van de klasse ByteArray kan worden gemanipuleerd met de standaardoperatoren [] (arraytoegang). Deze kan ook worden gelezen en geschreven als een bestand in het geheugen, hiervoor gebruikt u methoden die vergelijkbaar zijn met de methoden van de klassen URLStream en Socket.

Hiernaast wordt zlib-, deflate- en Izma-compressie en -decompressie ondersteund en AMF-objectserienummering (Action Message Format).

Een ByteArray-object kan zijn back-upgeheugen delen met meerdere workerinstanties door zijn eigenschap shareable in te stellen op true.

U kunt de klasse ByteArray onder meer als volgt gebruiken:

  • Het maken van een aangepast protocol om verbinding met de server te maken.
  • Het schrijven van uw eigen URLEncoder/URLDecoder.
  • Het schrijven van uw eigen AMF/Remoting-pakket.
  • Het optimaliseren van de grootte van de gegevens door gegevenstypen te gebruiken.
  • Werken met binaire gegevens die zijn geladen uit een bestand.

Bekijk de voorbeelden

Verwante API-elementen



Openbare eigenschappen
 EigenschapGedefinieerd door
  bytesAvailable : uint
[alleen-lezen] Het aantal gegevensbytes dat beschikbaar is om te worden gelezen vanaf de huidige positie in de bytearray tot het einde van de array.
ByteArray
 Inheritedconstructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.
Object
  defaultObjectEncoding : uint
[statisch] Hiermee wordt de standaardobjectcodering voor de klasse ByteArray aangegeven die moet worden gebruikt voor een nieuwe instantie ByteArray.
ByteArray
  endian : String
Wijzigt of leest de bytevolgorde voor de gegevens: Endian.BIG_ENDIAN of Endian.LITTLE_ENDIAN.
ByteArray
  length : uint
De lengte van het object ByteArray, in bytes.
ByteArray
  objectEncoding : uint
Wordt gebruikt om te bepalen of de indeling voor ActionScript 3.0, ActionScript 2.0 of ActionScript 1.0 moet worden gebruikt wanneer wordt geschreven naar of gelezen uit een instantie ByteArray.
ByteArray
  position : uint
Hiermee wordt de huidige positie, in bytes, van de bestandsaanwijzer verplaatst, of geretourneerd, naar het object ByteArray.
ByteArray
  shareable : Boolean
Geeft aan of het onderliggende geheugen van de bytearray kan worden gedeeld via de eigenschap shareable.
ByteArray
Openbare methoden
 MethodeGedefinieerd door
  
Hiermee wordt een instantie ByteArray gemaakt die een gecomprimeerde array van bytes vertegenwoordigt, zodat u de methoden en eigenschappen van deze klasse kunt gebruiken voor het optimaliseren van gegevensopslag en -stroom.
ByteArray
  
atomicCompareAndSwapIntAt(byteIndex:int, expectedValue:int, newValue:int):int
In een enkele atomische bewerking wordt de waarde van een integer in deze bytearray vergeleken met een andere integerwaarde. Als de waarden overeenkomen, worden de bytes omgewisseld met een andere waarde.
ByteArray
  
atomicCompareAndSwapLength(expectedLength:int, newLength:int):int
In een enkele atomische bewerking wordt de lengte van deze bytearray vergeleken met een opgegeven waarde. Als de waarden overeenkomen, wordt de lengte van deze bytearray gewijzigd.
ByteArray
  
Hiermee wist u de inhoud van de bytearray en stelt u eigenschappen length en position weer in op 0.
ByteArray
  
compress(algorithm:String):void
Hiermee wordt de bytearray gecomprimeerd.
ByteArray
  
Hiermee wordt de bytearray gecomprimeerd met het compressiealgoritme deflate.
ByteArray
 Inherited
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.
Object
  
Hiermee wordt de bytearray gedecomprimeerd met het compressiealgoritme deflate.
ByteArray
 Inherited
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.
Object
 Inherited
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.
Object
  
Leest een booleaanse waarde uit de bytestream.
ByteArray
  
Leest een byte met teken uit de bytestream.
ByteArray
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Leest het aantal gegevensbytes dat met de parameter length is opgegeven, uit de bytestream.
ByteArray
  
Leest een IEEE 754 drijvende-kommagetal (64-bits) met dubbele precisie uit de bytestream.
ByteArray
  
Leest een IEEE 754 drijvende-kommagetal (32-bits) met enkele precisie uit de bytestream.
ByteArray
  
Leest een 32-bits geheel getal met teken uit de bytestream.
ByteArray
  
readMultiByte(length:uint, charSet:String):String
Leest een multibyte-tekenreeks van de opgegeven lengte met de opgegeven tekenset uit de bytestream.
ByteArray
  
Leest een object dat in AMF-indeling met serienummering is gecodeerd, uit de bytearray.
ByteArray
  
Leest een 16-bits geheel getal met teken uit de bytestream.
ByteArray
  
Leest een byte zonder teken uit de bytestream.
ByteArray
  
Leest een 32-bits geheel getal zonder teken uit de bytestream.
ByteArray
  
Leest een 16-bits geheel getal zonder teken uit de bytestream.
ByteArray
  
Leest een UTF-8-tekenreeks uit de bytestream.
ByteArray
  
Leest een reeks UTF-8-bytes die met de parameter length is opgegeven, uit de bytestream en retourneert een tekenreeks.
ByteArray
 Inherited
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.
Object
  
Geeft een overschrijfbare methode op voor het aanpassen van de JSON-codering van waarden in een ByteArray-object.
ByteArray
 Inherited
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.
Object
  
Hiermee wordt bytearray in een tekenreeks omgezet.
ByteArray
  
Hiermee wordt de bytearray gedecomprimeerd.
ByteArray
 Inherited
Retourneert de primitieve waarde van het opgegeven object.
Object
  
Schrijft een booleaanse waarde.
ByteArray
  
Schrijft een byte naar de bytestream.
ByteArray
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Schrijft een reeks van length-bytes vanuit de opgegeven bytearray naar de bytestream, beginnend bij offset-bytes (index is op nul gebaseerd).
ByteArray
  
Hiermee wordt een IEEE 754 drijvende-kommagetal (64-bits) met dubbele precisie naar de bytestream geschreven.
ByteArray
  
Hiermee wordt een IEEE 754 drijvende-kommagetal (32-bits) met enkele precisie naar de bytestream geschreven.
ByteArray
  
Schrijft een 32-bits geheel getal met teken naar de bytestream.
ByteArray
  
Schrijft een multibyte-tekenreeks naar de bytestream met de opgegeven tekenset.
ByteArray
  
Schrijft een object in de bytearray in AMF-indeling met serienummering.
ByteArray
  
Schrijft een 16-bits geheel getal naar de bytestream.
ByteArray
  
Schrijft een 32-bits geheel getal zonder teken naar de bytestream.
ByteArray
  
Schrijft een UTF-8-tekenreeks naar de bytestream.
ByteArray
  
Schrijft een UTF-8-tekenreeks naar de bytestream.
ByteArray
Eigenschapdetails

bytesAvailable

eigenschap
bytesAvailable:uint  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Het aantal gegevensbytes dat beschikbaar is om te worden gelezen vanaf de huidige positie in de bytearray tot het einde van de array.

Gebruik de eigenschap bytesAvailable samen met de methoden read wanneer u het object ByteArray gebruikt om te zorgen dat u geldige gegevens leest.



Implementatie
    public function get bytesAvailable():uint

defaultObjectEncoding

eigenschap 
defaultObjectEncoding:uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt de standaardobjectcodering voor de klasse ByteArray aangegeven die moet worden gebruikt voor een nieuwe instantie ByteArray. Wanneer u een nieuwe instantie ByteArray maakt, begint de codering van die instantie met de waarde van defaultObjectEncoding. De eigenschap defaultObjectEncoding wordt geïnitialiseerd naar ObjectEncoding.AMF3.

Wanneer een object wordt geschreven naar of gelezen van binaire gegevens, wordt de waarde objectEncoding gebruikt om te bepalen of de indeling van ActionScript 3.0, ActionScript2.0 of ActionScript 1.0 moet worden gebruikt. De waarde is een constante van de klasse ObjectEncoding.



Implementatie
    public static function get defaultObjectEncoding():uint
    public static function set defaultObjectEncoding(value:uint):void

Verwante API-elementen

endian

eigenschap 
endian:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Wijzigt of leest de bytevolgorde voor de gegevens: Endian.BIG_ENDIAN of Endian.LITTLE_ENDIAN. De standaardwaarde is BIG_ENDIAN.



Implementatie
    public function get endian():String
    public function set endian(value:String):void

Verwante API-elementen

length

eigenschap 
length:uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De lengte van het object ByteArray, in bytes.

Wanneer de lengte is ingesteld op een waarde die groter is dan de huidige lengte, wordt de rechterzijde van de bytearray met nullen gevuld.

Wanneer de lengte is ingesteld op een waarde die kleiner is dan de huidige lengte, wordt de bytearray ingekort.



Implementatie
    public function get length():uint
    public function set length(value:uint):void

objectEncoding

eigenschap 
objectEncoding:uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Wordt gebruikt om te bepalen of de indeling voor ActionScript 3.0, ActionScript 2.0 of ActionScript 1.0 moet worden gebruikt wanneer wordt geschreven naar of gelezen uit een instantie ByteArray. De waarde is een constante van de klasse ObjectEncoding.



Implementatie
    public function get objectEncoding():uint
    public function set objectEncoding(value:uint):void

Verwante API-elementen

position

eigenschap 
position:uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt de huidige positie, in bytes, van de bestandsaanwijzer verplaatst, of geretourneerd, naar het object ByteArray. Dit is het punt waarop de volgende aanroep van een methode read begint met lezen of van een methode write begint met schrijven.



Implementatie
    public function get position():uint
    public function set position(value:uint):void

shareable

eigenschap 
shareable:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.5, AIR 3.5

Geeft aan of het onderliggende geheugen van de bytearray kan worden gedeeld via de eigenschap shareable. Voor een deelbarre bytearray maken alle ByteArray-instanties in alle workers die verwijzen naar de bytearray, gebruik van hetzelfde onderliggende systeemgeheugen. De standaardwaarde is false. Dit betekent dat het onderliggende geheugen niet wordt gedeeld door de workers.

Deze eigenschap heeft ook invloed op wat de runtime doet met deze bytearray als de array wordt doorgegeven aan een worker via de methode Worker.setSharedProperty() of de methode MessageChannel.send():

  • Not shareable: als deze eigenschap is ingesteld op false, maakt de runtime een volledige kopie van de bytearray wanneer de bytearray wordt doorgegeven aan een worker. Hierbij wordt ook een nieuw geheugensegment toegewezen waarin de inhoud van de duplicaatbytearray wordt opgeslagen
  • Shareable: wanneer een bytearray wordt doorgegeven aan een worker en deze eigenschap is ingesteld op true, gebruikt de runtime hetzelfde onderliggende geheugen als de opslagbuffer voor de inhoud van zowel de oorspronkelijke ByteArray-instantie en de nieuwe ByteArray-instantie die voor de tweede worker wordt gemaakt. In essentie bevatten beide ByteArray-instanties een referentie naar dezelfde onderliggende bytearray.

Wanneer een gedeelde bytearray gelijktijdig toegankelijk is voor meerdere workers, kan er een ongewenste situatie ontstaan waarbij het onderliggende geheugen van de bytearray gelijktijdig wordt bewerkt door twee workers. U kunt de toegang tot het gedeelde geheugen op een aantal verschillende manieren beheren:

  • via het vergelijk-en-omwisselmechanisme van de methoden atomicCompareAndSwapIntAt() en atomicCompareAndSwapLength() van de ByteArray-klasse
  • via de gespecialiseerde mechanismen van de Mutex- en Condition-klassen (in het flash.concurrent-pakket)

Als u de waarde van deze eigenschap instelt op true, is dat alleen van invloed op de volgende code die via deze bytearray wordt doorgegeven aan een worker. Elke kopie van deze bytearray die al is doorgegeven aan een worker, blijft bestaan als afzonderlijke kopie.

Als u de waarde van deze eigenschap instelt op false wanneer deze eerder was ingesteld op true, wordt het onderliggende geheugen van de bytearray direct gekopieerd naar een nieuw segment in het systeemgeheugen. Vervolgens wordt dan het nieuwe onderliggende geheugen gebruikt door deze ByteArray-instantie. Als gevolg hiervan wordt het onderliggende geheugen van deze bytearray niet meer gedeeld met andere workers, ook als dit voorheen wel het geval was. Als u deze bytearray nu doorgeeft aan een worker, wordt het onderliggende geheugen gekopieerd, net als bij elk ander ByteArray-object waarvan de eigenschap shareable is ingesteld op false.

De standaardwaarde is false.



Implementatie
    public function get shareable():Boolean
    public function set shareable(value:Boolean):void

Verwante API-elementen

Constructordetails

ByteArray

()Constructor
public function ByteArray()

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt een instantie ByteArray gemaakt die een gecomprimeerde array van bytes vertegenwoordigt, zodat u de methoden en eigenschappen van deze klasse kunt gebruiken voor het optimaliseren van gegevensopslag en -stroom.

Methodedetails

atomicCompareAndSwapIntAt

()methode
public function atomicCompareAndSwapIntAt(byteIndex:int, expectedValue:int, newValue:int):int

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.5, AIR 3.5

In een enkele atomische bewerking wordt de waarde van een integer in deze bytearray vergeleken met een andere integerwaarde. Als de waarden overeenkomen, worden de bytes omgewisseld met een andere waarde.

Deze methode is bedoeld voor gebruik met een bytearray waarvan het onderliggende geheugen wordt gedeeld tussen meerdere workers (de shareable-eigenschap van de ByteArray-instantie heeft de waarde true). De methode voert de volgende reeks stappen uit:

  1. De waarde van een integer in deze bytearray wordt gelezen, te beginnen bij de index (gemeten in bytes) die is opgegeven in het argument byteIndex
  2. De werkelijke waarde van deze bytearray wordt vergeleken met de waarde die is doorgegeven aan het argument expectedValue
  3. Als beide waarden gelijk zijn, wordt deze naar het argument newValue in de bytearray geschreven en wel op de locatie die is opgegeven door de parameter byteIndex. Vervolgens wordt de waarde geretourneerd die zich voorheen in de desbetreffende bytes bevond (de waarde die in stap 1 werd gelezen)
  4. Als de waarden niet gelijk zijn, verandert de inhoud van de bytearray niet en retourneert de methode de werkelijke gelezen waarde van de bytearray.

Alle bovenstaande stappen worden uitgevoerd in één atomische hardwaretransactie. Dit garandeert dat de inhoud van de bytearray tijdens de vergelijk-en-omwisselbewerking niet wordt gewijzigd door bewerkingen van andere workers.

Parameters

byteIndex:int — de indexpositie (in bytes) waar de te lezen integer zich bevindt, en waarnaar de waarde van newValue wordt geschreven als de vergeleken waarden overeenkomen. Deze waarde moet een meervoud van 4 zijn.
 
expectedValue:int — de waarde waarvan wordt verwacht dat deze overeenkomt met de inhoud van de bytearray bij de opgegeven index.
 
newValue:int — de nieuwe waarde die de inhoud van de bytearray bij de opgegeven index vervangt indien de vergeleken waarden overeenkomen

Geretourneerde waarde
int — de voorgaande waarde bij de opgegeven locatie als de vergelijking resulteert in overeenkomende waarden, of de werkelijke waarde van de bytearray als de werkelijke waarde niet overeenkomt met de verwachte waarde

Gegenereerde uitzondering
ArgumentError — indien de waarde van byteIndex geen meervoud van 4 of de overeenkomstige negatieve waarde is

Verwante API-elementen

atomicCompareAndSwapLength

()methode 
public function atomicCompareAndSwapLength(expectedLength:int, newLength:int):int

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.5, AIR 3.5

In een enkele atomische bewerking wordt de lengte van deze bytearray vergeleken met een opgegeven waarde. Als de waarden overeenkomen, wordt de lengte van deze bytearray gewijzigd.

Deze methode is bedoeld voor gebruik met een bytearray waarvan het onderliggende geheugen wordt gedeeld tussen meerdere workers (de shareable-eigenschap van de ByteArray-instantie heeft de waarde true). Deze methode doet het volgende:

  1. De eigenschap length van de integer van de ByteArray-instantie wordt gelezen
  2. Deze lengte wordt vergeleken met de waarde die is doorgegeven aan het argument expectedLength
  3. Als beide waarden gelijk zijn, wordt de lengte van de bytearray gewijzigd in de waarde die is doorgegeven als de parameter newLength, waardoor de bytearray groter of kleiner wordt
  4. Als de waarden niet overeenkomen, blijft de bytearray ongewijzigd

Alle bovenstaande stappen worden uitgevoerd in één atomische hardwaretransactie. Dit garandeert dat de inhoud van de bytearray tijdens de vergelijk-en-lengtewijzigingbewerking niet wordt gewijzigd door bewerkingen van andere workers.

Parameters

expectedLength:int — de verwachte waarde van de length-eigenschap van de ByteArray. Als de opgegeven waarde gelijk is aan de werkelijke waarde, wordt de lengte van de bytearray gewijzigd.
 
newLength:int — de nieuwe lengte van de bytearray, indien de waarden gelijk zijn

Geretourneerde waarde
int — de voorgaande length-waarde van de ByteArray, onafhankelijk of deze al dan niet is gewijzigd

Verwante API-elementen

clear

()methode 
public function clear():void

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee wist u de inhoud van de bytearray en stelt u eigenschappen length en position weer in op 0. Door deze methode aan te roepen, maakt u het geheugen vrij dat door de ByteArray-instantie werd gebruikt.

compress

()methode 
public function compress(algorithm:String):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9

Hiermee wordt de bytearray gecomprimeerd. De gehele bytearray wordt gecomprimeerd. Na de aanroep wordt de eigenschap length van ByteArray ingesteld op de nieuwe lengte. De eigenschap position wordt ingesteld op het einde van de bytearray.

U kunt een compressiealgoritme opgeven door een waarde (gedefinieerd in de klasse CompressionAlgorithm) in te voeren als algorithm-parameter. De volgende algoritmen worden ondersteund:

De zlib-gecomprimeerde gegevensindeling wordt beschreven in http://www.ietf.org/rfc/rfc1950.txt.

Het compressiealgoritme deflate wordt beschreven op http://www.ietf.org/rfc/rfc1951.txt.

Het lzma-compressiealgoritme wordt beschreven op http://www.7-zip.org/7z.html.

Het compressiealgoritme deflate wordt in verschillende compressie-indelingen gebruikt, zoals zlib, gzip, een aantal zip-implementaties, en andere. Wanneer gegevens met een van die compressie-indelingen worden gecomprimeerd, bevatten deze (bijvoorbeeld in het zip-bestand), naast de gecomprimeerde versie van de oorspronkelijke gegevens, metagegevens-informatie. Enkele soorten metagegevens in verschillende bestandsindelingen zijn bijvoorbeeld bestandsnaam, datum/tijdstip van wijziging van het bestand, oorspronkelijke grootte van het bestand, optioneel commentaar, checksumgegevens, enzovoort.

Wanneer bijvoorbeeld een ByteArray wordt gecomprimeerd met het algoritme zlib, is de resulterende ByteArray volgens een bepaalde indeling gestructureerd. Bepaalde bytes bevatten metagegevens over de gecomprimeerde gegevens, terwijl andere bytes de werkelijke gecomprimeerde versie van de oorspronkelijke ByteArray-gegevens bevatten. Die bytes (dat wil zeggen, het deel met de gecomprimeerde versie van de oorspronkelijke gegevens) worden gecomprimeerd met het algoritme deflate, zoals gedefinieerd in de specificatie zlib voor de indeling van gecomprimeerde gegevens. Die bytes zijn daarom identiek aan het resultaat van het aanroepen van compress(air. CompressionAlgorithm.DEFLATE) voor de oorspronkelijke ByteArray. Het resultaat van compress(air. CompressionAlgorithm.ZLIB) bevat de extra metagegevens, terwijl het resultaat van compress(CompressionAlgorithm.DEFLATE) alleen de gecomprimeerde versie bevat van de oorspronkelijke ByteArray-gegevens, en niets meer.

Als u de deflate-indeling wilt gebruiken om de gegevens van een ByteArray-instantie in een specifieke indeling te comprimeren, bijvoorbeeld gzip of zip, kunt u niet gewoon de methode compress(CompressionAlgorithm.DEFLATE) aanroepen. U moet een ByteArray maken die is gestructureerd volgens de specificatie van de compressie-indeling en er derhalve voor zorgen dat de ByteArray onder meer beschikt over de juiste metagegevens en over de gecomprimeerde gegevens die met de deflate-indeling zijn verkregen. Als u gegevens wilt decoderen die zijn gecomprimeerd in een indeling als gzip of zip kunt u dus ook niet gewoon uncompress(CompressionAlgorithm.DEFLATE) op die gegevens aanroepen. U moet eerst de metagegevens scheiden van de gecomprimeerde gegevens, waarna u de indeling deflate kunt gebruiken om de gecomprimeerde gegevens te decomprimeren.

Parameters

algorithm:String (default = NaN) — Het bij compressie te gebruiken compressiealgoritme. Geldige waarden worden gedefinieerd als constanten in de klasse CompressionAlgorithm. Standaard wordt de indeling zlib gebruikt. Het aanroepen van de methode compress(CompressionAlgorithm.DEFLATE) heeft hetzelfde effect als het aanroepen van de methode deflate(). Ondersteuning voor het lzma-algoritme is toegevoegd voor Flash Player 11.3 en AIR 3.3. Als u het lzma-compressiealgoritme wilt gebruiken, moet u over deze of latere versies beschikken.

Verwante API-elementen

deflate

()methode 
public function deflate():void

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee wordt de bytearray gecomprimeerd met het compressiealgoritme deflate. De gehele bytearray wordt gecomprimeerd.

Na de aanroep wordt de eigenschap length van ByteArray ingesteld op de nieuwe lengte. De eigenschap position wordt ingesteld op het einde van de bytearray.

Het compressiealgoritme deflate wordt beschreven op http://www.ietf.org/rfc/rfc1951.txt.

Als u de indeling deflate wilt gebruiken om de gegevens van een ByteArray-instantie in een specifieke indeling te comprimeren, zoals gzip of zip, kunt u niet gewoon deflate() aanroepen. U moet een ByteArray maken die is gestructureerd volgens de specificatie van de compressie-indeling en er derhalve voor zorgen dat de ByteArray onder meer beschikt over de juiste metagegevens en over de gecomprimeerde gegevens die met de deflate-indeling zijn verkregen. Als u gegevens wilt decoderen die zijn gecomprimeerd in een indeling als gzip of zip, kunt u dus ook niet gewoon inflate() voor die gegevens aanroepen. U moet eerst de metagegevens scheiden van de gecomprimeerde gegevens, waarna u de indeling deflate kunt gebruiken om de gecomprimeerde gegevens te decomprimeren.

Verwante API-elementen

inflate

()methode 
public function inflate():void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 10

Hiermee wordt de bytearray gedecomprimeerd met het compressiealgoritme deflate. De bytearray moet met hetzelfde algoritme zijn gecomprimeerd.

Na de aanroep wordt de eigenschap length van ByteArray ingesteld op de nieuwe lengte. De eigenschap position wordt ingesteld op 0.

Het compressiealgoritme deflate wordt beschreven op http://www.ietf.org/rfc/rfc1951.txt.

Als u gegevens wilt decoderen die zijn gecomprimeerd in een indeling die het compressiealgoritme deflate gebruikt, zoals gegevens in de indeling gzip of zip, kunt u niet gewoon inflate() aanroepen voor een ByteArray met de compressie-indelingsgegevens. Eerst moet u de metagegevens die onderdeel zijn van de gecomprimeerde gegevensindeling scheiden van de werkelijk gecomprimeerde gegevens. Zie de beschrijving van de methode compress() voor meer informatie.


Gegenereerde uitzondering
IOError — De gegevens zijn geen geldige gecomprimeerde gegevens omdat ze niet zijn gecomprimeerd met hetzelfde compressiealgoritme als waarmee ze zijn gecomprimeerd.

Verwante API-elementen

readBoolean

()methode 
public function readBoolean():Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een booleaanse waarde uit de bytestream. Er wordt één byte gelezen en true wordt geretourneerd wanneer de byte niet gelijk is aan 0. Anders wordt false geretourneerd.

Geretourneerde waarde
Boolean — Hiermee wordt true geretourneerd als de byte niet-nul is, anders false.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readByte

()methode 
public function readByte():int

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een byte met teken uit de bytestream.

De geretourneerde waarde ligt in het bereik -128 t/m 127.

Geretourneerde waarde
int — Een geheel getal van -128 tot en met 127.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readBytes

()methode 
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest het aantal gegevensbytes dat door de parameter length is opgegeven, uit de bytestream. De bytes worden ingelezen in het object ByteArray dat is opgegeven door de parameter bytes en de bytes worden geschreven naar de doel-ByteArray, beginnend bij de positie die is opgegeven door offset.

Parameters

bytes:ByteArray — Het object ByteArray waarin gegevens worden ingelezen.
 
offset:uint (default = 0) — De offset (positie) in bytes waar de gelezen gegevens moeten worden geschreven.
 
length:uint (default = 0) — Het aantal bytes dat moet worden gelezen. De standaardwaarde 0 zorgt ervoor dat alle beschikbare gegevens worden gelezen.


Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
 
RangeError — De gecombineerde waarde van de opgegeven verschuiving en lengte is groter dan het maximum voor een uint.

readDouble

()methode 
public function readDouble():Number

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een IEEE 754 drijvende-kommagetal (64-bits) met dubbele precisie uit de bytestream.

Geretourneerde waarde
Number — Een drijvende-kommagetal (64 bits) met dubbele precisie.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readFloat

()methode 
public function readFloat():Number

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een IEEE 754 drijvende-kommagetal (32-bits) met enkele precisie uit de bytestream.

Geretourneerde waarde
Number — Een drijvende-kommagetal (32 bits) met enkele precisie.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readInt

()methode 
public function readInt():int

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een 32-bits geheel getal met teken uit de bytestream.

De geretourneerde waarde ligt in het bereik -2147483648 t/m 2147483647.

Geretourneerde waarde
int — Een 32-bits geheel getal met teken tussen -2147483648 en 2147483647.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readMultiByte

()methode 
public function readMultiByte(length:uint, charSet:String):String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een multibyte-tekenreeks van de opgegeven lengte met de opgegeven tekenset uit de bytestream.

Parameters

length:uint — Het aantal bytes van de bytestream dat moet worden gelezen.
 
charSet:String — De tekenreeks die de tekenset aangeeft die moet worden gebruikt om de bytes te interpreteren. Mogelijke tekensetreeksen zijn onder andere shift-jis, cn-gb, iso-8859-1 en andere. Zie Ondersteunde tekensets voor een complete lijst.

Opmerking: wanneer de waarde voor de parameter charSet niet wordt herkend door het huidige systeem, gebruikt de methode de standaardcodepagina van uw systeem als tekenset. De waarde voor de parameter charSet, zoals myTest.readMultiByte(22, 'iso-8859-01') die gebruikmaakt van 01 in plaats van 1, kan mogelijk werken op het systeem dat u voor het ontwikkelen gebruikt, maar niet op een ander systeem. Op het andere systeem gebruikt de toepassing de standaardcodepagina van het systeem.

Geretourneerde waarde
String — Een UTF-8-gecodeerde tekenreeks.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readObject

()methode 
public function readObject():*

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een object dat in AMF-indeling met serienummering is gecodeerd, uit de bytearray.

Geretourneerde waarde
* — Het gedeserialiseerde object.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

Verwante API-elementen

readShort

()methode 
public function readShort():int

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een 16-bits geheel getal met teken uit de bytestream.

De geretourneerde waarde ligt in het bereik -32768 t/m 32767.

Geretourneerde waarde
int — Een 16-bits geheel getal met teken tussen -32768 en 32767.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readUnsignedByte

()methode 
public function readUnsignedByte():uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een byte zonder teken uit de bytestream.

De geretourneerde waarde ligt in het bereik 0 t/m 255.

Geretourneerde waarde
uint — Een 32-bits geheel getal zonder teken tussen 0 en 255.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readUnsignedInt

()methode 
public function readUnsignedInt():uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een 32-bits geheel getal zonder teken uit de bytestream.

De geretourneerde waarde ligt in het bereik 0 t/m 4294967295.

Geretourneerde waarde
uint — Een 32-bits geheel getal zonder teken tussen 0 en 4294967295.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readUnsignedShort

()methode 
public function readUnsignedShort():uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een 16-bits geheel getal zonder teken uit de bytestream.

De geretourneerde waarde ligt in het bereik 0 t/m 65535.

Geretourneerde waarde
uint — Een 16-bits geheel getal zonder teken tussen 0 en 65535.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

readUTF

()methode 
public function readUTF():String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een UTF-8-tekenreeks uit de bytestream. Er wordt aangenomen dat de tekenreeks begint met een kort geheel getal zonder teken dat de lengte in bytes aangeeft.

Geretourneerde waarde
String — Een UTF-8-gecodeerde tekenreeks.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

Verwante API-elementen

readUTFBytes

()methode 
public function readUTFBytes(length:uint):String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Leest een reeks UTF-8-bytes die met de parameter length is opgegeven, uit de bytestream en retourneert een tekenreeks.

Parameters

length:uint — Een kort geheel getal zonder teken dat de lengte van de UTF-8-bytes aangeeft.

Geretourneerde waarde
String — Een tekenreeks die bestaat uit de UTF-8-bytes van de opgegeven lengte.

Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.

toJSON

()methode 
public function toJSON(k:String):*

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11, AIR 3, Flash Lite 4

Geeft een overschrijfbare methode op voor het aanpassen van de JSON-codering van waarden in een ByteArray-object.

De JSON.stringify()-methode zoekt naar een toJSON()-methode op elk object dat deze doorloopt. Als de toJSON()-methode gevonden wordt, roept JSON.stringify() deze aan voor elke waarde die wordt gevonden en wordt deze doorgegeven in de sleutel die een paar vormt met de waarde.

ByteArray biedt een standaardimplementatie van toJSON() dat gewoon de naam van de klasse retourneert. Omdat de inhoud van een ByteArray interpretatie vereist, moeten clients die ByteArray-objecten willen exporteren naar JSON, hun eigen implementatie opgeven. U kunt dit doen door de toJSON()-methode op het klasseprototype opnieuw te definiëren.

De toJSON()-methode kan een waarde van elk type retourneren. Als een object wordt geretourneerd, loopt stringify() recursief door dat object. Als toJSON() een tekenreeks retourneert, loopt stringify() niet recursief door de tekenreeks en gaat de methode verder met doorlopen van de tekenreeks.

Parameters

k:String — De sleutel van een sleutel-waardepaar dat JSON.stringify() heeft gevonden tijdens het doorlopen van dit object

Geretourneerde waarde
* — De tekenreeks van de klassenaam.

Verwante API-elementen

toString

()methode 
public function toString():String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt bytearray in een tekenreeks omgezet. Wanneer de gegevens in de array met een Unicode-bytevolgordeteken beginnen, neemt de toepassing dit in beschouwing wanneer de gegevens in een tekenreeks worden omgezet. Wanneer System.useCodePage op true is ingesteld, behandelt de toepassing de gegevens in de array tijdens het omzetten alsof ze zich op de systeemcodepagina bevinden.

Geretourneerde waarde
String — De tekenreeksrepresentatie van de bytearray.

uncompress

()methode 
public function uncompress(algorithm:String):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt de bytearray gedecomprimeerd. Na de aanroep wordt de eigenschap length van ByteArray ingesteld op de nieuwe lengte. De eigenschap position wordt ingesteld op 0.

De bytearray moet met hetzelfde algoritme zijn gecomprimeerd als waarmee de array wordt gedecomprimeerd. U kunt een decompressiealgoritme opgeven door een waarde (gedefinieerd in de klasse CompressionAlgorithm) in te voeren als algorithm-parameter. De volgende algoritmen worden ondersteund:

De zlib-gecomprimeerde gegevensindeling wordt beschreven in http://www.ietf.org/rfc/rfc1950.txt.

Het compressiealgoritme deflate wordt beschreven op http://www.ietf.org/rfc/rfc1951.txt.

Het lzma-compressiealgoritme wordt beschreven op http://www.7-zip.org/7z.html.

Als u gegevens wilt decoderen die zijn gecomprimeerd in een indeling die het compressiealgoritme deflate gebruikt, zoals gegevens in de indeling gzip of zip, werkt het aanroepen van uncompress(CompressionAlgorithm.DEFLATE) op een ByteArray met de compressie-indelingsgegevens niet. Eerst moet u de metagegevens die onderdeel zijn van de gecomprimeerde gegevensindeling scheiden van de werkelijk gecomprimeerde gegevens. Zie de beschrijving van de methode compress() voor meer informatie.

Parameters

algorithm:String (default = NaN) — Het bij decompressie te gebruiken compressiealgoritme. Dit moet hetzelfde compressiealgoritme zijn dat is gebruikt voor compressie van de gegevens. Geldige waarden worden gedefinieerd als constanten in de klasse CompressionAlgorithm. Standaard wordt de indeling zlib gebruikt. Ondersteuning voor het lzma-algoritme is toegevoegd voor Flash Player 11.3 en AIR 3.3. Als u het lzma-compressiealgoritme wilt gebruiken, moet u over deze of latere versies beschikken.


Gegenereerde uitzondering
IOError — De gegevens zijn geen geldige gecomprimeerde gegevens omdat ze niet zijn gecomprimeerd met hetzelfde compressiealgoritme als waarmee ze zijn gecomprimeerd.

Verwante API-elementen

writeBoolean

()methode 
public function writeBoolean(value:Boolean):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een booleaanse waarde. Er wordt volgens de parameter value één byte geschreven, 1 indien true of 0 indien false.

Parameters

value:Boolean — Een booleaanse waarde die bepaalt welke byte wordt geschreven. Wanneer de parameter true is, schrijft de methode een 1; als de parameter false is, schrijft de methode een 0.

writeByte

()methode 
public function writeByte(value:int):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een byte naar de bytestream.

De lage 8 bits van de parameter worden gebruikt. De hoge 24 bits worden genegeerd.

Parameters

value:int — Een 32-bits geheel getal. De lage 8 bits worden naar de bytestream geschreven.

writeBytes

()methode 
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een reeks van length bytes vanuit de opgegeven byte array naar de bytestream, beginnend bij offset bytes (index is op nul gebaseerd).

Wanneer de parameter length wordt weggelaten, wordt de standaardlengte 0 gebruikt. De methode schrijft de gehele buffer, beginnend bij offset. Wanneer de parameter offset ook wordt weggelaten, wordt de gehele buffer geschreven.

Wanneer offset of length zich buiten het bereik bevindt, worden ze vastgeklemd aan het begin en einde van de array bytes.

Parameters

bytes:ByteArray — Het object ByteArray.
 
offset:uint (default = 0) — Een op nul gebaseerde index die de positie in de array opgeeft waar met schrijven moet worden begonnen.
 
length:uint (default = 0) — Een geheel getal zonder teken dat aangeeft tot hoever in de buffer moet worden geschreven.

writeDouble

()methode 
public function writeDouble(value:Number):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt een IEEE 754 drijvende-kommagetal (64-bits) met dubbele precisie naar de bytestream geschreven.

Parameters

value:Number — Een drijvende-kommagetal (64 bits) met dubbele precisie.

writeFloat

()methode 
public function writeFloat(value:Number):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt een IEEE 754 drijvende-kommagetal (32-bits) met enkele precisie naar de bytestream geschreven.

Parameters

value:Number — Een drijvende-kommagetal (32 bits) met enkele precisie.

writeInt

()methode 
public function writeInt(value:int):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een 32-bits geheel getal met teken naar de bytestream.

Parameters

value:int — Een geheel getal dat naar de bytestream moet worden geschreven.

writeMultiByte

()methode 
public function writeMultiByte(value:String, charSet:String):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een multibyte-tekenreeks naar de bytestream met de opgegeven tekenset.

Parameters

value:String — De tekenreekswaarde die moet worden geschreven.
 
charSet:String — De tekenreeks die de tekenset aangeeft die moet worden gebruikt. Mogelijke tekensetreeksen zijn onder andere shift-jis, cn-gb, iso-8859-1 en andere. Zie Ondersteunde tekensets voor een complete lijst.

writeObject

()methode 
public function writeObject(object:*):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een object in de bytearray in AMF-indeling met serienummering.

Parameters

object:* — Het object waarop serienummering moet worden toegepast.

Verwante API-elementen

writeShort

()methode 
public function writeShort(value:int):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een 16-bits geheel getal naar de bytestream. De lage 16 bits van de parameter worden gebruikt. De hoge 16 bits worden genegeerd.

Parameters

value:int — Een 32-bits geheel getal, waarvan de lage 16 bits naar de bytestream worden geschreven.

writeUnsignedInt

()methode 
public function writeUnsignedInt(value:uint):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een 32-bits geheel getal zonder teken naar de bytestream.

Parameters

value:uint — Een geheel getal zonder teken dat naar de bytestream moet worden geschreven.

writeUTF

()methode 
public function writeUTF(value:String):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een UTF-8-tekenreeks naar de bytestream. De lengte van de UTF-8-tekenreeks in bytes wordt eerst als een 16-bits geheel getal geschreven en wordt gevolgd door de bytes die de tekens van de tekenreeks vertegenwoordigen.

Parameters

value:String — De tekenreekswaarde die moet worden geschreven.


Gegenereerde uitzondering
RangeError — Wanneer de lengte groter is dan 65535.

writeUTFBytes

()methode 
public function writeUTFBytes(value:String):void

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Schrijft een UTF-8-tekenreeks naar de bytestream. Vergelijkbaar met de methode writeUTF(), maar writeUTFBytes() voegt geen 16-bits woord als voorvoegsel toe aan de tekenreeks.

Parameters

value:String — De tekenreekswaarde die moet worden geschreven.

ByteArrayExample.as

In het volgende voorbeeld wordt de klasse ByteArrayExample gebruikt om een booleaanse waarde en een representatie van pi als drijvende-kommagetal met dubbele precisie naar een byte-array te schrijven. Hierbij moeten de volgende stappen worden uitgevoerd:
  1. Declareer een nieuwe ByteArray-objectinstantie byteArr.
  2. Schrijf de waarde van de booleaanse waarde false in bytes, controleer de lengte en lees het opnieuw.
  3. Schrijf de wiskundige waarde van pi met een drijvende-kommagetal met dubbele precisie.
  4. Lees de negen bytes die in de bytearray zijn geschreven opnieuw.

Opmerking: wanneer trace() wordt aangeroepen voor een byte, wordt de decimale equivalent van de bytes die zijn opgeslagen in de bytearray afgedrukt.

Aan het eind is een codesegment toegevoegd om op bestandseindefouten te controleren en te zorgen dat de bytestream niet voorbij het einde wordt gelezen.

package {
    import flash.display.Sprite;
    import flash.utils.ByteArray;
    import flash.errors.EOFError;

    public class ByteArrayExample extends Sprite {        
        public function ByteArrayExample() {
            var byteArr:ByteArray = new ByteArray();

            byteArr.writeBoolean(false);
            trace(byteArr.length);            // 1
            trace(byteArr[0]);            // 0

            byteArr.writeDouble(Math.PI);
            trace(byteArr.length);            // 9
            trace(byteArr[0]);            // 0
            trace(byteArr[1]);            // 64
            trace(byteArr[2]);            // 9
            trace(byteArr[3]);            // 33
            trace(byteArr[4]);            // 251
            trace(byteArr[5]);            // 84
            trace(byteArr[6]);            // 68
            trace(byteArr[7]);            // 45
            trace(byteArr[8]);            // 24
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean() == false); // true
            } 
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
            
            try {
                trace(byteArr.readDouble());        // 3.141592653589793
            }
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
            
            try {
                trace(byteArr.readDouble());
            } 
            catch(e:EOFError) {
                trace(e);            // EOFError: Error #2030: End of file was encountered.
            }
        }
    }
}




[ X ]Waarom in het Engels?
Sommige inhoud van de Naslaggids voor ActionScript 3.0 staat in het Engels

Niet alle onderdelen van de Naslaggids voor ActionScript 3.0 zijn in alle talen vertaald. Wanneer een taalelement niet is vertaald, wordt het in het Engels weergegeven. Zo is de klasse ga.controls.HelpBox niet in elke taal vertaald. In de Nederlandse versie van de naslaggids wordt de klasse ga.controls.HelpBox bijvoorbeeld in het Engels weergegeven.