Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
flash.utils 

ByteArray  - AS3

Pacchettix

Primo livello
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

Elementi del linguaggio

Costanti globali
Funzioni globali
Operatori
Istruzioni, parole chiave e direttive
Tipi speciali

Appendici

Novità
Errori del compilatore
Avvisi del compilatore
Errori runtime
Migrazione a ActionScript 3
Set di caratteri supportati
Tag solo di MXML
Elementi XML di Motion
Tag Timed Text
Elenco degli elementi obsoleti
Costanti di implementazione dell’accessibilità
Utilizzare gli esempi ActionScript
Note legali
Pacchettoflash.utils
Classepublic class ByteArray
EreditarietàByteArray Inheritance Object
Implementa IDataInput, IDataOutput
Sottoclassi ByteArrayAsset

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La classe ByteArray fornisce metodi e proprietà per ottimizzare la lettura, scrittura e l'uso di dati binari.

Nota: la classe ByteArray è destinata agli sviluppatori esperti che necessitano di accedere ai dati a livello di byte.

I dati in memoria sono un array compresso (la rappresentazione più compatta del tipo di dati) di byte, ma un'istanza della classe ByteArray può essere manipolata mediante gli operatori standard [] (accesso array). Può anche essere letta e scritta in un file in memoria, utilizzando metodi simili a quelli delle classi URLStream e Socket.

Inoltre, sono supportate la compressione e decompressione zlib, deflate e lzma, e la serializzazione oggetto AMF (Action Message Format).

Un oggetto ByteArray può condividere la propria memoria di supporto con più istanze worker impostandone la propria proprietà shareable su true.

La classe ByteArray può essere utilizzata per le seguenti operazioni:

  • Creare un protocollo personalizzato per la connnessione a un server.
  • Scrivere un vostro URLEncoder/URLDecoder.
  • Scrivere un vostro pacchetto AMF/Remoting.
  • Ottimizzare le dimensioni dei dati mediante i tipi di dati.
  • Utilizzare dati binari caricati da un file.

Vedere gli esempi

Altri esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
  bytesAvailable : uint
[sola lettura] Il numero di byte di dati disponibili per la lettura dalla posizione corrente dell'array di byte alla fine dell'array.
ByteArray
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  defaultObjectEncoding : uint
[statico] Denota la codifica oggetto predefinita che la classe ByteArray deve utilizzare per una nuova istanza ByteArray.
ByteArray
  endian : String
Modifica o legge l'ordine dei byte dei dati: costante BIG_ENDIAN o LITTLE_ENDIAN.
ByteArray
  length : uint
La lunghezza dell'oggetto ByteArray in byte.
ByteArray
  objectEncoding : uint
Consente di determinare se deve essere utilizzato il formato ActionScript 3.0, 2.0 o 1.0 per scrivere su o leggere da un'istanza ByteArray.
ByteArray
  position : uint
Sposta o restituisce la posizione corrente (in byte) del puntatore di file nell'oggetto ByteArray.
ByteArray
  shareable : Boolean
Specifica se la memoria sottostante dell’array di byte è condivisibile.
ByteArray
Metodi pubblici
 MetodoDefinito da
  
Crea un'istanza ByteArray che rappresenta un array compresso di byte, in modo che sia possibile utilizzare i metodi e le proprietà della classe per ottimizzare l'archiviazione e il flusso dei dati.
ByteArray
  
atomicCompareAndSwapIntAt(byteIndex:int, expectedValue:int, newValue:int):int
In una singola operazione atomica, confronta un valore intero di questo array di byte con un altro valore intero e, se coincidono, scambia i relativi byte con un altro valore.
ByteArray
  
atomicCompareAndSwapLength(expectedLength:int, newLength:int):int
In una singola operazione atomica, confronta la lunghezza di questo array di byte con un valore specificato e, se i due valori coincidono, modifica la lunghezza di questo array di byte.
ByteArray
  
Cancella il contenuto dell'array di byte e reimposta le proprietà length e position su 0.
ByteArray
  
compress(algorithm:String):void
Comprime l'array di byte.
ByteArray
  
Comprime l'array di byte utilizzando l'algoritmo di compressione deflate.
ByteArray
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
  
Decomprime l'array di byte utilizzando l'algoritmo di compressione deflate.
ByteArray
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
Legge un valore booleano dal flusso di byte.
ByteArray
  
Legge un byte con segno dal flusso di byte.
ByteArray
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Legge il numero di byte di dati, specificato dal parametro lunghezza, dal flusso di byte.
ByteArray
  
Legge un numero a virgola mobile IEEE 754 a precisione doppia (64 bit) dal flusso di byte.
ByteArray
  
Legge un numero a virgola mobile IEEE 754 a precisione singola (32 bit) dal flusso di byte.
ByteArray
  
Legge un numero intero con segno a 32 bit dal flusso di byte.
ByteArray
  
readMultiByte(length:uint, charSet:String):String
Legge una stringa multibyte della lunghezza specificata dal flusso di byte, utilizzando il set di caratteri specificato.
ByteArray
  
Legge un oggetto dall'array di byte, codificato nel formato serializzato AMF.
ByteArray
  
Legge un numero intero con segno a 16 bit dal flusso di byte.
ByteArray
  
Legge un byte senza segno dal flusso di byte.
ByteArray
  
Legge un numero intero senza segno a 32 bit dal flusso di byte.
ByteArray
  
Legge un numero intero senza segno a 16 bit dal flusso di byte.
ByteArray
  
Legge una stringa UTF-8 dal flusso di byte.
ByteArray
  
Legge una sequenza di byte UTF-8 specificata dal parametro lunghezza dal flusso di byte e restituisce una stringa.
ByteArray
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
Fornisce un metodo sostituibile per personalizzare la codifica JSON dei valori in un oggetto ByteArray.
ByteArray
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
  
Converte l'array di byte in una stringa.
ByteArray
  
Decomprime l'array di byte.
ByteArray
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
  
Scrive un valore booleano.
ByteArray
  
Scrive un byte nel flusso di byte.
ByteArray
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Scrive una sequenza di byte (del numero indicato dal parametro length) dall'array di byte specificato (bytes), a partire dal numero di byte offset (numero intero a base zero) nel flusso di byte.
ByteArray
  
Scrive un numero a virgola mobile IEEE 754 a precisione doppia (64 bit) nel flusso di byte.
ByteArray
  
Scrive un numero a virgola mobile IEEE 754 a precisione singola (32 bit) nel flusso di byte.
ByteArray
  
Scrive un numero intero con segno a 32 bit nel flusso di byte.
ByteArray
  
Scrive una stringa multibyte in un flusso di byte utilizzando il set di caratteri specificato.
ByteArray
  
Scrive un oggetto nell'array di byte nel formato serializzato AMF.
ByteArray
  
Scrive un numero intero a 16 bit nel flusso di byte.
ByteArray
  
Scrive un numero intero senza segno a 32 bit nel flusso di byte.
ByteArray
  
Scrive una stringa UTF-8 nel flusso di byte.
ByteArray
  
Scrive una stringa UTF-8 nel flusso di byte.
ByteArray
Descrizione delle proprietà

bytesAvailable

proprietà
bytesAvailable:uint  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il numero di byte di dati disponibili per la lettura dalla posizione corrente dell'array di byte alla fine dell'array.

Utilizzate la proprietà bytesAvailable in combinazione con i metodi di lettura ogni volta che si accede a un oggetto ByteArray per verificare che i dati letti siano validi.



Implementazione
    public function get bytesAvailable():uint

defaultObjectEncoding

proprietà 
defaultObjectEncoding:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Denota la codifica oggetto predefinita che la classe ByteArray deve utilizzare per una nuova istanza ByteArray. Quando si crea una nuova istanza ByteArray, la codifica dell'istanza inizia con il valore di defaultObjectEncoding. La proprietà defaultObjectEncoding è inizializzata su ObjectEncoding.AMF3.

Quando un oggetto viene scritto o letto da dati binari, il valore objectEncoding consente di determinare se deve essere utilizzato il formato ActionScript 3.0, 2.0 o 1.0. Questo valore è una costante della classe ObjectEncoding.



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

Elementi API correlati

endian

proprietà 
endian:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Modifica o legge l’ordine dei byte dei dati: Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN. Il valore predefinito è BIG_ENDIAN.



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

Elementi API correlati

length

proprietà 
length:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La lunghezza dell'oggetto ByteArray in byte.

Se invece è impostata su un valore superiore alla lunghezza corrente, il lato destro dell'array di byte viene riempito di zeri.

Se la lunghezza è impostata su un valore inferiore alla lunghezza corrente, l'array di byte viene troncato.



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

objectEncoding

proprietà 
objectEncoding:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Consente di determinare se deve essere utilizzato il formato ActionScript 3.0, 2.0 o 1.0 per scrivere su o leggere da un'istanza ByteArray. Questo valore è una costante della classe ObjectEncoding.



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

Elementi API correlati

position

proprietà 
position:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Sposta o restituisce la posizione corrente (in byte) del puntatore di file nell'oggetto ByteArray. Questo è il punto in cui la successiva chiamata a un metodo di lettura o di scrittura avvia, rispettivamente, la lettura o la scrittura.



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

shareable

proprietà 
shareable:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11.5, AIR 3.5

Specifica se la memoria sottostante dell’array di byte è condivisibile (shareable). Per un array di byte condivisibile (shareable), tutte le istanze ByteArray in tutti i worker che fanno riferimento all’array di byte usano la stessa memoria di sistema sottostante. Il valore predefinito è false e indica che la memoria sottostante non è condivisa tra i worker.

Questa proprietà determina anche l’operazione che il runtime esegue su questo array di byte se viene passato a un worker con il metodo Worker.setSharedProperty() o il metodo MessageChannel.send():

  • Non condivisibile: se questa proprietà è false, quando l’array di byte viene passato a un worker il runtime crea una copia completa dell’array di byte, allocando anche un nuovo segmento di memoria nel quale memorizzare il contenuto dell’array di byte duplicato.
  • Condivisibile: se questa proprietà è true, quando l’array di byte viene passato a un worker il runtime usa la stessa memoria sottostante del buffer di memorizzazione sia per il contenuto dell’istanza ByteArray originale che per la nuova istanza ByteArray creata per il secondo worker. In pratica, entrambe le istanze ByteArray contengono un riferimento allo stesso array di byte sottostante.

La possibilità di accedere a un array di byte condiviso da più worker simultaneamente può determinare una situazione indesiderata quando due worker modificano la memoria sottostante dell’array byte contemporaneamente. Potete usare vari meccanismi per controllare l’accesso alla memoria condivisa:

  • I meccanismi di confronto e scambio forniti dai metodi atomicCompareAndSwapIntAt() e atomicCompareAndSwapLength() della classe ByteArray
  • I meccanismi specializzati forniti dalle classi Mutex e Condition (nel pacchetto flash.concurrent)

L’impostazione di questa proprietà su true ha effetto solo sul codice successivo che passa questo array di byte a un worker. Qualsiasi copia di questo array di byte che è stata già passata a un worker continua a esistere come copia separata.

Se impostate questa proprietà su false quando in precedenza era true, la memoria sottostante dell’array di byte viene immediatamente copiata in un nuovo segmento della memoria di sistema. Questa istanza ByteArray usa quindi da quel momento la nuova memoria sottostante. Di conseguenza, la memoria sottostante di questo array di byte non è più condivisa con altri worker, anche se lo era in precedenza. Se successivamente passate questo array di byte a un worker, la sua memoria sottostante viene copiata come per qualsiasi oggetto ByteArray la cui proprietà shareable è false.

Il valore predefinito è false.



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

Elementi API correlati

Descrizione della funzione di costruzione

ByteArray

()Funzione di costruzione
public function ByteArray()

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Crea un'istanza ByteArray che rappresenta un array compresso di byte, in modo che sia possibile utilizzare i metodi e le proprietà della classe per ottimizzare l'archiviazione e il flusso dei dati.

Descrizione dei metodi

atomicCompareAndSwapIntAt

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11.5, AIR 3.5

In una singola operazione atomica, confronta un valore intero di questo array di byte con un altro valore intero e, se coincidono, scambia i relativi byte con un altro valore.

Questo metodo è pensato per essere utilizzato con un array di byte la cui memoria sottostante è condivisa tra più worker (la proprietà shareable dell’istanza ByteArray è true). Esegue la seguente sequenza di passaggi:

  1. Legge un valore intero dall’array di byte a partire dall’indice (misurato in byte) specificato nell’argomento byteIndex.
  2. Confronta il valore effettivo di questo array di byte con il valore passato nell’argomento expectedValue.
  3. Se i due valori sono uguali, scrive il valore dell’argomento newValue nell’array di byte in corrispondenza della posizione specificata dal parametro byteIndex e restituisce il valore precedentemente contenuto in quei byte (il valore letto al punto 1).
  4. Altrimenti, il contenuto dell’array di byte non viene cambiato e il metodo restituisce il valore effettivo letto dall’array di byte.

Tutti questi passaggi vengono effettuati in un’unica transazione hardware atomica. In questo modo viene garantito che nessuna operazione eseguita da altri worker modifichi il contenuto dell’array di byte l’operazione di confronto e scambio.

Parametri

byteIndex:int — La posizione di indice (in byte) dalla quale il valore intero da confrontare viene letto e sulla quale il valore newValue viene scritto se il confronto determina valori coincidenti. Questo valore deve essere un multiplo di 4.
 
expectedValue:int — Il valore atteso che dovrebbe corrispondere al contenuto dell’array di byte nella posizione di indice specificata.
 
newValue:int — Il nuovo valore che sostituisce il contenuto dell’array di byte nella posizione di indice specificata se il confronto determina valori coincidenti.

Restituisce
int — Il valore precedente nella posizione specificata, se il confronto determina valori coincidenti, oppure il valore effettivo dell’array di byte, se il valore effettivo e il valore atteso non corrispondono.

Genera
ArgumentError — Se il valore byteIndex non è un multiplo di 4 oppure se è negativo.

Elementi API correlati

atomicCompareAndSwapLength

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11.5, AIR 3.5

In una singola operazione atomica, confronta la lunghezza di questo array di byte con un valore specificato e, se i due valori coincidono, modifica la lunghezza di questo array di byte.

Questo metodo è pensato per essere utilizzato con un array di byte la cui memoria sottostante è condivisa tra più worker (la proprietà shareable dell’istanza ByteArray è true). Esegue le seguenti operazioni:

  1. Legge la proprietà length (valore intero) dell’istanza ByteArray.
  2. Confronta la lunghezza con il valore passato nell’argomento expectedLength.
  3. Se i due valori sono uguali, cambia la lunghezza dell’array di byte con il valore passato nel parametro newLength, aumentando o riducendo la dimensione dell’array di byte.
  4. In caso contrario, l’array di byte rimane invariato.

Tutti questi passaggi vengono effettuati in un’unica transazione hardware atomica. In questo modo viene garantito che nessuna operazione eseguita da altri worker modifichi il contenuto dell’array di byte l’operazione di confronto e ridimensionamento.

Parametri

expectedLength:int — Il valore atteso della proprietà length del ByteArray. Se il valore specificato e il valore effettivo corrispondono, la lunghezza dell’array di byte viene modificata.
 
newLength:int — Il nuovo valore di lunghezza dell’array di byte se il confronto ha esito positivo.

Restituisce
int — Il valore length precedente del ByteArray, indipendentemente dal fatto che sia cambiato o meno.

Elementi API correlati

clear

()metodo 
public function clear():void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5, Flash Lite 4

Cancella il contenuto dell'array di byte e reimposta le proprietà length e position su 0. Chiamando questo metodo, si libera in modo esplicito la memoria utilizzata dall'istanza ByteArray.

compress

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Comprime l'array di byte. Viene compresso l'intero array. Dopo la chiamata, viene impostata una nuova lunghezza della proprietà length del ByteArray. La proprietà position viene impostata alla fine dell'array di byte.

Specificate un algoritmo di compressione passando un valore (definito nella classe CompressionAlgorithm) come parametro algorithm. Gli algoritmi supportati sono i seguenti:

È possibile leggere la descrizione del formato di dati compresso zlib alle pagine e http://www.ietf.org/rfc/rfc1950.txt.

L'algoritmo di compressione deflate è descritto all'indirizzo http://www.ietf.org/rfc/rfc1951.txt.

L’algoritmo di compressione lzma è descritto qui: http://www.7-zip.org/7z.html.

L'algoritmo di compressione deflate viene utilizzato per diversi formati di compressione, quali zlib, gzip, alcune implementazioni di zip e altri ancora. Quando i dati vengono compressi utilizzando uno di questi formati di compressione, oltre a memorizzare la versione compressa dei dati originali, i dati del formato di compressione (ad esempio, il file .zip) includono anche informazioni sui metadati. Alcuni esempi dei tipi di metadati inclusi in vari formati file sono nome del file, data/ora di modifica del file, dimensione del file originale, commenti opzionali, dati di checksum e altro ancora.

Ad esempio, quando ByteArray viene compresso mediante l'algoritmo zlib, l'oggetto ByteArray risultante viene strutturato in un formato specifico. Alcuni byte contengono metadati sui dati compressi, mentre altri byte contengono l'effettiva versione compressa dei dati ByteArray originali. Come definito dalla specifica del formato dei dati compressi zlib, tali byte (vale a dire, la parte contenente la versione compressa dei dati originali) vengono compressi mediante l'algoritmo deflate. Di conseguenza, tali byte sono identici al risultato della chiamata a compress(air.CompressionAlgorithm.DEFLATE) sul ByteArray originale. Tuttavia, il risultato di compress(air.(CompressionAlgorithm.ZLIB) include i metadati extra, mentre il risultato di compress(CompressionAlgorithm.DEFLATE) include solo la versione compressa dei dati di ByteArray originali e niente altro.

Per utilizzare il formato deflate per comprimere i dati di un'istanza di ByteArray in un formato specifico, quale gzip o zip, non è sufficiente chiamare compress( CompressionAlgorithm.DEFLATE) . Dovete invece creare un oggetto ByteArray strutturato in base alla specifica del formato di compressione, che includa i metadati appropriati, così come i dati compressi ottenuti utilizzando il formato deflate. Analogamente, per decodificare dati compressi in un formato quale gzip o zip, non è sufficiente chiamare uncompress(CompressionAlgorithm.DEFLATE) su tali dati. In primo luogo, dovete separare i metadati dai dati compressi, quindi potete usare il formato deflate per decomprimere i dati compressi.

Parametri

algorithm:String (default = NaN) — L'algoritmo di compressione da usare durante la compressione. I valori validi sono definiti come costanti nella classe CompressionAlgorithm. L'impostazione predefinita prevede l'uso del formato zlib. La chiamata di compress( CompressionAlgorithm.DEFLATE) produce gli stessi risultati della chiamata del metodo deflate(). Il supporto per l’algoritmo lzma è stato aggiunto per Flash Player 11.3 e AIR 3.3. Per utilizzare la compressione lzma dovete avere queste versioni dei lettori, o versioni successive.

Elementi API correlati

deflate

()metodo 
public function deflate():void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5, Flash Lite 4

Comprime l'array di byte utilizzando l'algoritmo di compressione deflate. Viene compresso l'intero array.

Dopo la chiamata, viene impostata una nuova lunghezza della proprietà length del ByteArray. La proprietà position viene impostata alla fine dell'array di byte.

L'algoritmo di compressione deflate è descritto all'indirizzo http://www.ietf.org/rfc/rfc1951.txt.

Per utilizzare il formato deflate per comprimere i dati di un'istanza di ByteArray in un formato specifico, quale gzip o zip, non è sufficiente chiamare il metodo deflate(). Dovete invece creare un oggetto ByteArray strutturato in base alla specifica del formato di compressione, che includa i metadati appropriati, così come i dati compressi ottenuti utilizzando il formato deflate. Analogamente, per decodificare dati compressi in un formato quale gzip o zip, non è sufficiente chiamare inflate() su tali dati. In primo luogo, dovete separare i metadati dai dati compressi, quindi potete usare il formato deflate per decomprimere i dati compressi.

Elementi API correlati

inflate

()metodo 
public function inflate():void

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 10

Decomprime l'array di byte utilizzando l'algoritmo di compressione deflate. L'array di byte deve essere stato compresso mediante lo stesso algoritmo.

Dopo la chiamata, viene impostata una nuova lunghezza della proprietà length del ByteArray. La proprietà position viene impostata su 0.

L'algoritmo di compressione deflate è descritto all'indirizzo http://www.ietf.org/rfc/rfc1951.txt.

Per decodificare dati compressi in un formato che impiega l'algoritmo di compressione deflate, quali dati in formato gzip o zip, non è sufficiente chiamare il metodo inflate() su un ByteArray contenente i dati nel formato di compressione. In primo luogo, dovete separare i metadati inclusi come parte del formato dati compresso dagli effettivi dati compressi. Per maggiori informazioni, vedete la descrizione del metodo compress().


Genera
IOError — I dati non sono dati compressi validi; non sono stati compressi con lo stesso algoritmo utilizzato per la compressione.

Elementi API correlati

readBoolean

()metodo 
public function readBoolean():Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un valore booleano dal flusso di byte. Viene letto un singolo byte e viene restituito true se il byte è diverso da zero oppure false in caso contrario.

Restituisce
Boolean — Restituisce true se il byte è diverso da zero; false in caso contrario.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readByte

()metodo 
public function readByte():int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un byte con segno dal flusso di byte.

Il valore restituito è compreso nell'intervallo da -128 a 127.

Restituisce
int — Un numero intero compreso tra -128 e 127.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readBytes

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge il numero di byte di dati, specificato dal parametro length, dal flusso di byte. I byte vengono letti dall'oggetto ByteArray specificato dal parametro bytes e poi scritti nel ByteArray di destinazione a partire dalla posizione specificata dall'offset.

Parametri

bytes:ByteArray — L'oggetto ByteArray in cui leggere i dati.
 
offset:uint (default = 0) — L'offset (posizione) in byte in corrispondenza del quale devono essere scritti i dati letti.
 
length:uint (default = 0) — Il numero di byte da leggere. Il valore predefinito 0 avvia la lettura di tutti i dati disponibili.


Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.
 
RangeError — Il valore combinato corrispondente all'offset e alla lunghezza forniti è maggiore del valore massimo per un uint.

Altri esempi

readDouble

()metodo 
public function readDouble():Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un numero a virgola mobile IEEE 754 a precisione doppia (64 bit) dal flusso di byte.

Restituisce
Number — Un numero a virgola mobile a precisione doppia (64 bit).

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readFloat

()metodo 
public function readFloat():Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un numero a virgola mobile IEEE 754 a precisione singola (32 bit) dal flusso di byte.

Restituisce
Number — Un numero a virgola mobile a precisione singola (32 bit).

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readInt

()metodo 
public function readInt():int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un numero intero con segno a 32 bit dal flusso di byte.

Il valore restituito è compreso nell'intervallo da -2147483648 a 2147483647.

Restituisce
int — Un numero intero con segno a 32 bit, compreso tra -2147483648 e 2147483647.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readMultiByte

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge una stringa multibyte della lunghezza specificata dal flusso di byte, utilizzando il set di caratteri specificato.

Parametri

length:uint — Il numero di byte dal flusso di byte da leggere.
 
charSet:String — La stringa che indica il set di caratteri da utilizzare per interpretare i byte. Le stringhe dei set di caratteri possono essere "shift-jis", "cn-gb", "iso-8859-1" e altre. Per un elenco completo, vedete Set di caratteri supportati.

Nota: se il valore del parametro charSet non è riconosciuto dal sistema corrente, l'applicazione impiega la pagina di codice predefinita del sistema come set di caratteri. Un valore, ad esempio, per il parametro charSet, come in myTest.readMultiByte(22, "iso-8859-01") che impiega 01 anziché 1 può funzionare sul sistema utilizzato per lo sviluppo, ma non su un altro sistema. Sull'altro sistema, l'applicazione utilizzerà la tabella codici predefinita del sistema.

Restituisce
String — Stringa con codifica UTF-8.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readObject

()metodo 
public function readObject():*

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un oggetto dall'array di byte, codificato nel formato serializzato AMF.

Restituisce
* — L'oggetto deserializzato.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

Elementi API correlati

readShort

()metodo 
public function readShort():int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un numero intero con segno a 16 bit dal flusso di byte.

Il valore restituito è compreso nell'intervallo da -32768 a 32767.

Restituisce
int — Un numero intero con segno a 16 bit, compreso tra -32768 e 32767.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readUnsignedByte

()metodo 
public function readUnsignedByte():uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un byte senza segno dal flusso di byte.

Il valore restituito è compreso nell'intervallo da 0 a 255.

Restituisce
uint — Un numero intero senza segno a 32 bit, compreso tra 0 e 255.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readUnsignedInt

()metodo 
public function readUnsignedInt():uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un numero intero senza segno a 32 bit dal flusso di byte.

Il valore restituito è compreso nell'intervallo da 0 a 4294967295.

Restituisce
uint — Un numero intero senza segno a 32 bit, compreso tra 0 e 4294967295.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readUnsignedShort

()metodo 
public function readUnsignedShort():uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge un numero intero senza segno a 16 bit dal flusso di byte.

Il valore restituito è compreso nell'intervallo da 0 a 65535.

Restituisce
uint — Un numero intero senza segno a 16 bit, compreso tra 0 e 65535.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

readUTF

()metodo 
public function readUTF():String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge una stringa UTF-8 dal flusso di byte. Si presume che la stringa abbia come prefisso una dichiarazione unsigned short, che indica la lunghezza in byte.

Restituisce
String — Stringa con codifica UTF-8.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

Elementi API correlati

readUTFBytes

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Legge una sequenza di byte UTF-8 specificata dal parametro length dal flusso di byte e restituisce una stringa.

Parametri

length:uint — Una dichiarazione unsigned short che indica la lunghezza dei byte UTF-8.

Restituisce
String — Una stringa composta dai byte UTF-8 della lunghezza specificata.

Genera
EOFError — I dati disponibili non sono sufficienti per la lettura.

toJSON

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11, AIR 3, Flash Lite 4

Fornisce un metodo sostituibile per personalizzare la codifica JSON dei valori in un oggetto ByteArray.

Il metodo JSON.stringify() cerca un metodo toJSON() in ogni oggetto che ricerca. Se il metodo toJSON() viene rilevato, JSON.stringify() lo chiama per ogni valore che incontra, trasmettendo la chiave accoppiata al valore.

ByteArray fornisce un'implementazione predefinita di toJSON() che restituisce semplicemente il nome della classe. Poiché il contenuto di ciascun ByteArray richiede un'interpretazione, i clienti che desiderano esportare oggetti ByteArray in JSON devono fornire una loro implementazione. Potete eseguire questa operazione ridefinendo il metodo toJSON() sul prototipo della classe.

Il metodo toJSON() è in grado di restituire qualsiasi tipo di valore. Se viene restituito un oggetto, stringify() esegue la ricorsione all'interno di tale oggetto. Se toJSON() restituisce una stringa, stringify() non esegue alcuna ricorsione e continua la ricerca.

Parametri

k:String — La chiave di una coppia chiave/valore che JSON.stringify() ha incontrato durante la ricerca di questo oggetto.

Restituisce
* — La stringa del nome della classe.

Altre informazioni

Elementi API correlati

toString

()metodo 
public function toString():String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Converte l'array di byte in una stringa. Se i dati nell'array iniziano con un BOM Unicode, l'applicazione rispetta questo contrassegno durante la conversione in stringa. Se System.useCodePage è impostato su true, i dati dell'array vengono considerati parte della tabella codici del sistema corrente durante la conversione.

Restituisce
String — La rappresentazione in stringa dell'array di byte.

uncompress

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Decomprime l'array di byte. Dopo la chiamata, viene impostata una nuova lunghezza della proprietà length del ByteArray. La proprietà position viene impostata su 0.

L’array di byte deve essere stato compresso mediante lo stesso algoritmo usato per la decompressione. Specificate un algoritmo di decompressione passando un valore (definito nella classe CompressionAlgorithm) come parametro algorithm. Gli algoritmi supportati sono i seguenti:

È possibile leggere la descrizione del formato di dati compresso zlib alle pagine e http://www.ietf.org/rfc/rfc1950.txt.

L'algoritmo di compressione deflate è descritto all'indirizzo http://www.ietf.org/rfc/rfc1951.txt.

L’algoritmo di compressione lzma è descritto qui: http://www.7-zip.org/7z.html.

Per decodificare dati compressi in un formato che impiega l'algoritmo di compressione deflate, quali dati in formato gzip o zip, non è possibile chiamare uncompress(CompressionAlgorithm.DEFLATE) su un oggetto ByteArray contenente i dati nel formato di compressione. In primo luogo, dovete separare i metadati inclusi come parte del formato dati compresso dagli effettivi dati compressi. Per maggiori informazioni, vedete la descrizione del metodo compress().

Parametri

algorithm:String (default = NaN) — L'algoritmo di compressione da usare durante la decompressione. Deve trattarsi dello stesso algoritmo di compressione utilizzato per comprimere i dati. I valori validi sono definiti come costanti nella classe CompressionAlgorithm. L'impostazione predefinita prevede l'uso del formato zlib. Il supporto per l’algoritmo lzma è stato aggiunto per Flash Player 11.3 e AIR 3.3. Per utilizzare la compressione lzma dovete avere queste versioni dei lettori, o versioni successive.


Genera
IOError — I dati non sono dati compressi validi; non sono stati compressi con lo stesso algoritmo utilizzato per la compressione.

Elementi API correlati

writeBoolean

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un valore booleano. Viene scritto un singolo byte a seconda del parametro value: 1 se true oppure 0 se false.

Parametri

value:Boolean — Un valore booleano che determina il byte da scrivere. Se il parametro è true, il metodo scrive 1; se è false, scrive 0.

writeByte

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un byte nel flusso di byte.

Vengono utilizzati i 8 bit bassi del parametro. I 24 bit alti vengono ignorati.

Parametri

value:int — Numero intero a 32 bit. Gli 8 bit bassi vengono scritti nel flusso di byte.

writeBytes

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive una sequenza di byte length dall'array di byte specificato, bytes, a partire dal numero di byte offset (numero intero a base zero) nel flusso di byte.

Se il parametro length viene omesso, viene utilizzata la lunghezza predefinita 0 e il metodo scrive l'intero buffer partendo da offset. Se viene omesso anche il parametro offset, viene scritto l'intero buffer.

Se offset o length è fuori intervallo, viene fissato all'inizio e alla fine dell'array bytes.

Parametri

bytes:ByteArray — L'oggetto ByteArray.
 
offset:uint (default = 0) — Un numero intero a base zero, che indica la posizione dell'array da cui viene avviata la scrittura.
 
length:uint (default = 0) — Un numero intero senza segno, che indica fin dove scrivere nel buffer.

Altri esempi

writeDouble

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un numero a virgola mobile IEEE 754 a precisione doppia (64 bit) nel flusso di byte.

Parametri

value:Number — Un numero a virgola mobile a precisione doppia (64 bit).

writeFloat

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un numero a virgola mobile IEEE 754 a precisione singola (32 bit) nel flusso di byte.

Parametri

value:Number — Un numero a virgola mobile a precisione singola (32 bit).

writeInt

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un numero intero con segno a 32 bit nel flusso di byte.

Parametri

value:int — Un numero intero da scrivere nel flusso di byte.

writeMultiByte

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive una stringa multibyte in un flusso di byte utilizzando il set di caratteri specificato.

Parametri

value:String — Il valore stringa da scrivere.
 
charSet:String — La stringa che indica il set di caratteri da utilizzare. Le stringhe dei set di caratteri possono essere "shift-jis", "cn-gb", "iso-8859-1" e altre. Per un elenco completo, vedete Set di caratteri supportati.

writeObject

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un oggetto nell'array di byte nel formato serializzato AMF.

Parametri

object:* — L'oggetto da serializzare.

Elementi API correlati

writeShort

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un numero intero a 16 bit nel flusso di byte. Vengono utilizzati i 16 bit bassi del parametro. I 16 bit alti vengono ignorati.

Parametri

value:int — Numero intero a 32 bit, i cui 16 bit bassi vengono scritti nel flusso di byte.

writeUnsignedInt

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive un numero intero senza segno a 32 bit nel flusso di byte.

Parametri

value:uint — Un numero intero senza segno da scrivere nel flusso di byte.

writeUTF

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive una stringa UTF-8 nel flusso di byte. La lunghezza della stringa UTF-8 in byte viene scritta per prima, come numero intero a 16 bit, seguita dai byte che rappresentano i caratteri della stringa.

Parametri

value:String — Il valore stringa da scrivere.


Genera
RangeError — La lunghezza supera 65535.

writeUTFBytes

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Scrive una stringa UTF-8 nel flusso di byte. È simile al metodo writeUTF(), ma writeUTFBytes() non inserisce come prefisso alla stringa una parola di 16 bit.

Parametri

value:String — Il valore stringa da scrivere.

ByteArrayExample.as

L'esempio seguente utilizza la classe ByteArrayExample per scrivere un valore booleano e la rappresentazione di pi a virgola mobile e a precisione doppia in un array di byte. Questa operazione viene eseguita mediante la procedura seguente:
  1. Dichiarate una nuova istanza dell'oggetto ByteArray byteArr.
  2. Scrivete l'equivalente in byte del valore booleano false, quindi verificarne la lunghezza ed eseguirne la lettura.
  3. Scrivete l'equivalente a virgola mobile e precisione doppia del valore matematico di pi.
  4. Leggere ognuno dei nove byte scritti nell'array di byte.

Nota: quando trace() viene chiamato su un byte, viene stampato l'equivalente decimale dei byte memorizzati nell'array di byte.

Notate che alla fine viene aggiunto un segmento di codice per verificare la presenza di errori di fine del file e assicurare che il flusso di byte non venga letto oltre il suo punto finale.

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 ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.