Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: AIR 30.0 y versiones anteriores, Flash Player 30.0 y versiones anteriores, Flash Lite 4
Flex 4.6 y versiones anteriores, Flash Pro CS6 y versiones anteriores
Ocultar filtros
flash.utils 

ByteArray  - AS3

Paquetesx

Nivel superior
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

Elementos del lenguaje

Constantes globales
Funciones globales
Operadores
Sentencias, palabras clave y directivas
Tipos especiales

Apéndices

Novedades
Errores del compilador
Advertencias del compilador
Errores en tiempo de ejecución
Migración a ActionScript 3
Conjuntos de caracteres admitidos
Solo etiquetas MXML
Elementos Motion XML
Etiquetas de texto temporizado
Lista de elementos desfasados
Constantes de implementación de accesibilidad
Cómo utilizar ejemplos de ActionScript
Avisos legales
Paqueteflash.utils
Clasepublic class ByteArray
HerenciaByteArray Inheritance Object
Implementa IDataInput, IDataOutput
Subclases ByteArrayAsset

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La clase ByteArray proporciona métodos y propiedades para optimizar la lectura, escritura y trabajo con datos binarios.

Nota: la clase ByteArray está pensada para desarrolladores avanzados de que necesiten acceder al nivel de bytes de los datos.

Los datos en memoria son un conjunto empaquetado de bytes (la representación más compacta para este tipo de datos), pero se puede manipular una instancia de la clase ByteArray con los operadores habituales [] (acceso a conjuntos). También se puede leer y escribir como en un archivo en memoria; los métodos utilizados son similares a los de las clases URLStream y Socket.

Además, se admite la compresión y descompresión zlib, deflate y lzma, así como la serialización de objetos de formato de mensaje de acción (AMF).

Un objeto ByteArray puede compartir su memoria de reserva entre varias instancias de programas de trabajo mediante la definición de su propiedad shareable en true.

Éstos son algunos de los posibles usos de la clase ByteArray:

  • Creación de un protocolo personalizado para conectar con un servidor.
  • Escritura de sus propios URLEncoder/URLDecoder.
  • Escritura de su propio paquete AMF/remoto.
  • Optimización del tamaño de los datos gracias a los tipos de datos.
  • Trabajo con datos binarios cargados desde un archivo.

Ver los ejemplos

Elementos de API relacionados



Propiedades públicas
 PropiedadDefinido por
  bytesAvailable : uint
[solo lectura] El número de bytes de datos disponibles para su lectura desde la posición actual del conjunto de bytes hasta el final del conjunto.
ByteArray
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  defaultObjectEncoding : uint
[estática] Denota la codificación predeterminada del objeto para que la clase ByteArray lo utilice en una instancia nueva de ByteArray.
ByteArray
  endian : String
Cambia o lee el orden de bytes de los datos; puede ser Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN.
ByteArray
  length : uint
Longitud del objeto ByteArray, expresada en bytes.
ByteArray
  objectEncoding : uint
Se utiliza para determinar si se debe utilizar el formato ActionScript 3.0, 2.0 ó 1.0 al escribir o leer una instancia de ByteArray.
ByteArray
  position : uint
Desplaza (o devuelve) la posición actual (expresada en bytes) del puntero del archivo al objeto ByteArray.
ByteArray
  shareable : Boolean
Especifica si la memoria subyacente del conjunto de bytes es shareable (se puede compartir).
ByteArray
Métodos públicos
 MétodoDefinido por
  
Crea una instancia de ByteArray que representa un conjunto empaquetado de bytes, de modo que es posible utilizar los métodos y propiedades de esta clase para mejorar el flujo y almacenamiento de los datos.
ByteArray
  
atomicCompareAndSwapIntAt(byteIndex:int, expectedValue:int, newValue:int):int
En una única operación atómica, compara un valor entero en este conjunto de bytes con otro valor entero y, si coinciden, intercambia los bytes por otro valor.
ByteArray
  
atomicCompareAndSwapLength(expectedLength:int, newLength:int):int
En una única operación atómica, compara la longitud de este conjunto de bytes con un valor proporcionado y, si coinciden, cambia la longitud de este conjunto de bytes.
ByteArray
  
Borra el contenido del conjunto de bytes y restablece las propiedades length y position en 0.
ByteArray
  
compress(algorithm:String):void
Comprime el conjunto de bytes.
ByteArray
  
Comprime el conjunto de bytes con el algoritmo de compresión deflate.
ByteArray
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
  
Descomprime el conjunto de bytes con el algoritmo de compresión deflate.
ByteArray
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
  
Lee un valor booleano del flujo de bytes.
ByteArray
  
Lee un byte con signo del flujo de bytes.
ByteArray
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Lee el número de bytes de datos especificado por el parámetro length desde el flujo de bytes.
ByteArray
  
Lee un número de coma flotante (64 bits) con precisión doble IEEE 754 del flujo de bytes.
ByteArray
  
Lee un número de coma flotante (32 bits) con precisión simple IEEE 754 del flujo de bytes.
ByteArray
  
Lee un entero de 32 bits con signo del flujo de bytes.
ByteArray
  
readMultiByte(length:uint, charSet:String):String
Lee una cadena multibyte de longitud especificada desde la transmisión de bytes mediante el juego de caracteres especificado.
ByteArray
  
Lee un objeto del conjunto de bytes, codificado en formato serializado AMF.
ByteArray
  
Lee un entero de 16 bits con signo del flujo de bytes.
ByteArray
  
Lee un byte sin signo del flujo de bytes.
ByteArray
  
Lee un entero de 32 bits sin signo del flujo de bytes.
ByteArray
  
Lee un entero de 16 bits sin signo del flujo de bytes.
ByteArray
  
Lee una cadena UTF-8 del flujo de bytes.
ByteArray
  
Lee una secuencia de bytes UTF-8 especificada por el parámetro length desde el flujo de bytes y devuelve una cadena.
ByteArray
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
Proporciona un método anulable para personalizar la codificación JSON de valores de un objeto ByteArray.
ByteArray
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
  
Convierte el conjunto de bytes en una cadena.
ByteArray
  
Descomprime la matriz de bytes.
ByteArray
 Inherited
Devuelve el valor simple del objeto especificado.
Object
  
Escribe un valor booleano.
ByteArray
  
Escribe un byte en el flujo de bytes.
ByteArray
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Escribe una secuencia de bytes length desde el conjunto de bytes especificada, bytes, comenzando por bytes offset (índice basado en cero) en el flujo de bytes.
ByteArray
  
Escribe un número de coma flotante (64 bits) con precisión doble IEEE 754 en el flujo de bytes.
ByteArray
  
Escribe un número de coma flotante (32 bits) con precisión simple IEEE 754 en el flujo de bytes.
ByteArray
  
Escribe un entero de 32 bits con signo en el flujo de bytes.
ByteArray
  
Escribe una cadena multibyte en el flujo de bytes mediante el juego de caracteres especificado.
ByteArray
  
Escribe un objeto en el conjunto de bytes en formato serializado AMF.
ByteArray
  
Escribe un entero de 16 bits en el flujo de bytes.
ByteArray
  
Escribe un entero de 32 bits sin signo en el flujo de bytes.
ByteArray
  
Escribe una cadena UTF-8 en el flujo de bytes.
ByteArray
  
Escribe una cadena UTF-8 en el flujo de bytes.
ByteArray
Información sobre propiedades

bytesAvailable

propiedad
bytesAvailable:uint  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El número de bytes de datos disponibles para su lectura desde la posición actual del conjunto de bytes hasta el final del conjunto.

Utilice la propiedad bytesAvailable en combinación con los métodos de lectura cada vez que acceda a un objeto ByteArray para garantizar que los datos leídos son válidos.



Implementación
    public function get bytesAvailable():uint

defaultObjectEncoding

propiedad 
defaultObjectEncoding:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Denota la codificación predeterminada del objeto para que la clase ByteArray lo utilice en una instancia nueva de ByteArray. Al crear una nueva instancia de ByteArray, la codificación de dicha instancia se inicia con el valor de defaultObjectEncoding. La propiedad defaultObjectEncoding se inicializa en ObjectEncoding.AMF3.

Cuando se escribe o se lee un objeto a partir de datos binarios, se utiliza el valor objectEncoding para determinar si se debe utilizar el formato de ActionScript 3.0, 2.0 ó 1.0. El valor es una constante de la clase ObjectEncoding.



Implementación
    public static function get defaultObjectEncoding():uint
    public static function set defaultObjectEncoding(value:uint):void

Elementos de API relacionados

endian

propiedad 
endian:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Cambia o lee el orden de bytes de los datos; puede ser Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN. El valor predeterminado es BIG_ENDIAN.



Implementación
    public function get endian():String
    public function set endian(value:String):void

Elementos de API relacionados

length

propiedad 
length:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Longitud del objeto ByteArray, expresada en bytes.

Si la longitud se establece en un valor mayor que la longitud actual, la parte derecha del conjunto se llenará con ceros.

Si la longitud se establece como un valor inferior a la longitud actual, el conjunto de bytes se trunca.



Implementación
    public function get length():uint
    public function set length(value:uint):void

objectEncoding

propiedad 
objectEncoding:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Se utiliza para determinar si se debe utilizar el formato ActionScript 3.0, 2.0 ó 1.0 al escribir o leer una instancia de ByteArray. El valor es una constante de la clase ObjectEncoding.



Implementación
    public function get objectEncoding():uint
    public function set objectEncoding(value:uint):void

Elementos de API relacionados

position

propiedad 
position:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Desplaza (o devuelve) la posición actual (expresada en bytes) del puntero del archivo al objeto ByteArray. Se trata del punto en el que se inicia la lectura de la siguiente llamada a un método de lectura o la escritura de un método de escritura.



Implementación
    public function get position():uint
    public function set position(value:uint):void

shareable

propiedad 
shareable:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 11.5, AIR 3.5

Especifica si la memoria subyacente del conjunto de bytes es shareable (se puede compartir). En un conjunto de bytes compatible, todas las instancias de ByteArray de todos los programas de trabajo utilizan la misma memoria subyacente del sistema. El valor predeterminado es false e indica que la memoria subyacente no se comparte entre los programas de trabajo.

Esta propiedad también afecta a lo que hace el motor de ejecución con este conjunto de bytes si lo transfiere a otro programa de trabajo con el método Worker.setSharedProperty() o con el método MessageChannel.send():

  • Not shareable: si esta propiedad es false, cuando se transfiere el conjunto de bytes a un programa de trabajo, el motor de ejecución crea una copia completa del conjunto de bytes, incluida la asignación de un nuevo segmento de memoria en el que almacenar el contenido duplicado del conjunto de bytes
  • Shareable: si esta propiedad es true, cuando se transfiere el conjunto de bytes a un programa de trabajo, el motor de ejecución utiliza la misma memoria subyacente que el búfer de almacenamiento para el contenido de la instancia de ByteArray original y para la nueva instancia de ByteArray para el segundo programa de trabajo. En esencia, ambas instancias de ByteArray contienen una referencia al mismo conjunto de bytes subyacente.

La capacidad de acceder a un conjunto de bytes compartido desde diversos programas de trabajo al mismo tiempo puede provocar situaciones no deseadas en las que los dos programas de trabajo manipulen la memoria subyacente del conjunto de bytes al mismo tiempo. Puede recurrir a distintos mecanismos para controlar el acceso a la memoria compartida:

  • los mecanismos de comparación e intercambio proporcionados por los métodos atomicCompareAndSwapIntAt() y atomicCompareAndSwapLength() de la clase ByteArray
  • los mecanismos especializados proporcionados por las clases Mutex y Condition (en el paquete flash.concurrent)

Establecer esta propiedad en true solo afecta al siguiente código que transfiera este conjunto de bytes a un programa de trabajo. Una copia de este conjunto de bytes ya transferida a un programa de trabajo seguirá existiendo como copia independiente.

Si establece esta propiedad en false cuando previamente estaba definida como true, la memoria subyacente del conjunto de bytes se copiará inmediatamente en un nuevo segmento de la memoria del sistema. Seguidamente, la instancia de ByteArray utilizará la nueva memoria a partir de dicho punto. En consecuencia, la memoria subyacente de este conjunto de bytes ya no se compartirá con otros programas de trabajo incluso si se compartía previamente. Si posteriormente transfiere este conjunto de bytes a un programa de trabajo, su memoria subyacente se copiará como cualquier objeto ByteArray cuya propiedad shareable sea false.

El valor predeterminado es false.



Implementación
    public function get shareable():Boolean
    public function set shareable(value:Boolean):void

Elementos de API relacionados

Información sobre constructores

ByteArray

()Información sobre
public function ByteArray()

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Crea una instancia de ByteArray que representa un conjunto empaquetado de bytes, de modo que es posible utilizar los métodos y propiedades de esta clase para mejorar el flujo y almacenamiento de los datos.

Información sobre métodos

atomicCompareAndSwapIntAt

()método
public function atomicCompareAndSwapIntAt(byteIndex:int, expectedValue:int, newValue:int):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 11.5, AIR 3.5

En una única operación atómica, compara un valor entero en este conjunto de bytes con otro valor entero y, si coinciden, intercambia los bytes por otro valor.

Este método está diseñado para su uso con un conjunto de bytes cuya memoria subyacente se comparte entre diversos programas de trabajo (la propiedad shareable de la instancia de ByteArray es true). Lleva a cabo la siguiente secuencia de pasos:

  1. Lee un valor entero desde este conjunto de bytes comenzando en el índice (medido en bytes) especificado en el argumento byteIndex
  2. Compara el valor real de este conjunto de bytes con el valor transferido en el argumento expectedValue
  3. Si ambos valores son iguales, escribe el valor del argumento newValue en el conjunto de bytes en la ubicación especificada por el parámetro byteIndex y devuelve el valor contenido previamente en dichos bytes (el valor leído en el paso 1)
  4. En caso contrario, el contenido del conjunto de bytes no cambia y el método devuelve el valor real leído en el conjunto de bytes

Todos estos pasos se llevan a cabo en una transacción de hardware atómica. De esta forma se garantiza que ninguna operación de otros programas de trabajo realiza cambios en el contenido del conjunto de bytes durante el proceso de comparación e intercambio.

Parámetros

byteIndex:int — la posición del índice (en bytes) desde la que lee el entero para comparar y en la que ese escribe el valor de newValue si el resultado de la comparación es una coincidencia. Este valor debe ser múltiplo de 4.
 
expectedValue:int — el valor que se espera que coincida con el contenido del conjunto de bytes en el índice especificado
 
newValue:int — el nuevo valor que sustituye al contenido del conjunto de bytes en el índice especificado si el resultado de la comparación es una coincidencia

Valor devuelto
int — el valor anterior en la ubicación especificada si el resultado de la comparación es una coincidencia, o bien el valor real del conjunto de bytes si el valor real y el valor esperado no coinciden

Emite
ArgumentError — si el valor de byteIndex no es múltiplo de 4 o si es negativo

Elementos de API relacionados

atomicCompareAndSwapLength

()método 
public function atomicCompareAndSwapLength(expectedLength:int, newLength:int):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 11.5, AIR 3.5

En una única operación atómica, compara la longitud de este conjunto de bytes con un valor proporcionado y, si coinciden, cambia la longitud de este conjunto de bytes.

Este método está diseñado para su uso con un conjunto de bytes cuya memoria subyacente se comparte entre diversos programas de trabajo (la propiedad shareable de la instancia de ByteArray es true). Hace lo siguiente:

  1. Lee la propiedad length del entero de la instancia de ByteArray
  2. Compara la longitud con el valor transferido en el argumento expectedLength
  3. Si los dos valores son iguales, modifica la longitud del conjunto de bytes por la del valor transferido como argumento newLength, bien ampliando o reduciendo el tamaño del conjunto de bytes
  4. En caso contrario, no se modifica el conjunto de bytes

Todos estos pasos se llevan a cabo en una transacción de hardware atómica. Esto garantiza que ninguna operación de otros programas de trabajo pueda modificar el contenido del conjunto de bytes durante la operación de comparación y cambio de tamaño.

Parámetros

expectedLength:int — el valor esperado de la propiedad length de ByteArray. Si el valor especificado y el valor real coinciden, se modifica la longitud del conjunto de bytes.
 
newLength:int — el nuevo valor de longitud del conjunto de bytes si la comparación se realiza correctamente

Valor devuelto
int — el valor length previo de ByteArray, independientemente de si ha cambiado o no

Elementos de API relacionados

clear

()método 
public function clear():void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5, Flash Lite 4

Borra el contenido del conjunto de bytes y restablece las propiedades length y position en 0. Al llamar a este método, se libera explícitamente la memoria utilizada por la instancia de ByteArray.

compress

()método 
public function compress(algorithm:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

Comprime el conjunto de bytes. Se comprime todo el conjunto de bytes. Después de la llamada, la propiedad length de ByteArray se establece con la nueva longitud. La propiedad position se establece al final del conjunto de bytes.

Especifica un algoritmo de compresión transfiriendo un valor (definido en la clase CompressionAlgorithm) como el parámetro algorithm. Los algoritmos admitidos son los siguientes:

El formato de datos comprimidos zlib se describe en http://www.ietf.org/rfc/rfc1950.txt.

El algoritmo de compresión deflate se describ en http://www.ietf.org/rfc/rfc1951.txt.

El algoritmo de compresión lzma se describe en http://www.7-zip.org/7z.html.

El algoritmo de compresión deflate se utiliza en diversos formatos, como zlib, gzip, en algunas implementaciones de zip, etc. Cuando se comprien datos utilizando uno de estos formatos de compresión, además de almacenar la versión comprimida de los datos originales, los datos del formato compresión (por ejemplo, el archivo .zip) incluyen información de metadatos. Algunos ejemplos de los tipos de metadatos incluidos en los diversos formatos de archivo son el nombre de archivo, fecha y hora de modificación, tamaño del archivo original, comentarios opcionales, datos de suma de comprobación, etc.

Por ejemplo, cuando ByteArray se comprime utilizando el algoritmo zlib, el conjunto ByteArray resultante es estructura según en formato específico. Determinados bytes contienen metadatos sobre los datos comprimidos, y otros bytes contienen la versión comprimida de los datos originales de ByteArray. Tal como se define en la especificación del formato de datos comprimidos zlib, estos bytes (es decir, la parte que contiene la versión comprimida de los datos originales) se comprimen utilizando el algoritmo deflate. En consecuencia, dichos bytes son idénticos a los de la llamada a compress(air.CompressionAlgorithm.DEFLATE) en el objeto ByteArray original. Sin embargo, el resultado de compress( air.CompressionAlgorithm.ZLIB) incluye los metadatos adicionales, mientras que el resultado de compress( CompressionAlgorithm.DEFLATE) incluye solamente la versión comprimida de los datos ByteArray originales y nada más.

Para poder utilizar el formato deflate en la compresión de datos de una instancia de ByteArray en un formato concreto, como puede ser gzip o zip, no basta con llamar a compress( CompressionAlgorithm.DEFLATE). Se debe crear un conjunto ByteArray estructurado según la especificación del formato de comrpesión, incluidos los metadatos apropiados, así como los datos comprimidos obtenidos con el formato deflate. Del mismo modo, para poder descodificar datos comprimidos en formatos como gzip o zip, no basta con llamar a uncompress(CompressionAlgorithm.DEFLATE) en los datos. Primero se deben separar los metadatos de los datos comprimidos y, después, utilizar el formato deflate para descomprimirlos.

Parámetros

algorithm:String (default = NaN) — El algoritmo de compresión empleado durante la compresión. Los valores válidos se definen como constantes en la clase CompressionAlgorithm. La opción predeterminada es utilizar el formato zlib. Llamar a compress(CompressionAlgorithm.DEFLATE) tiene el mismo efecto que llamar al método deflate(). El soporte para el algoritmo lzma se añadió en Flash Player 11.3 y AIR 3.3. Debe tener dichas versiones del reproductor o una versión posterior para poder utilizar la compresión lzma.

Elementos de API relacionados

deflate

()método 
public function deflate():void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5, Flash Lite 4

Comprime el conjunto de bytes con el algoritmo de compresión deflate. Se comprime todo el conjunto de bytes.

Después de la llamada, la propiedad length de ByteArray se establece con la nueva longitud. La propiedad position se establece al final del conjunto de bytes.

El algoritmo de compresión deflate se describ en http://www.ietf.org/rfc/rfc1951.txt.

Para poder utilizar el formato deflate en la compresión de datos de una instancia de ByteArray en un formato concreto como puede ser gzip o zip, no basta con llamar a deflate(). Se debe crear un conjunto ByteArray estructurado según la especificación del formato de comrpesión, incluidos los metadatos apropiados, así como los datos comprimidos obtenidos con el formato deflate. Del mismo modo, para poder descodificar datos comprimidos en formatos como gzip o zip, no basta con llamar a inflate() en los datos. Primero se deben separar los metadatos de los datos comprimidos y, después, utilizar el formato deflate para descomprimirlos.

Elementos de API relacionados

inflate

()método 
public function inflate():void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 10

Descomprime el conjunto de bytes con el algoritmo de compresión deflate. El conjunto de bytes debe estar comprimido con el mismo algoritmo.

Después de la llamada, la propiedad length de ByteArray se establece con la nueva longitud. La propiedad position está establecida en 0.

El algoritmo de compresión deflate se describ en http://www.ietf.org/rfc/rfc1951.txt.

Para poder descodificar datos comprimidos en formatos de archivo que utilicen el algoritmo de compresión deflate, por ejemplo, datos en formato gzip o zip, no basta con llamar a inflate() en un conjunto ByteArray que contenga datos con ese formato de compresión. Primero se deben separar los metadatos que forman parte del formato de datos comprimidos de los datos actuales. Para obtener más información, consulte la descripción del método compress().


Emite
IOError — Los datos no son datos comprimidos válidos; no se comprimieron con el mismo algoritmo de compresión.

Elementos de API relacionados

readBoolean

()método 
public function readBoolean():Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un valor booleano del flujo de bytes. Se lee un solo byte y devuelve true si el byte es distinto de cero; en caso contrario, devuelve false.

Valor devuelto
Boolean — Devuelve true si el byte es distinto a cero; en caso contrario, devuelve false.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readByte

()método 
public function readByte():int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un byte con signo del flujo de bytes.

El valor devuelto se encuentra entre -128 y 127.

Valor devuelto
int — Un entero entre -128 y 127.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readBytes

()método 
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee el número de bytes de datos especificado por el parámetro length desde el flujo de bytes. Los bytes se leen en un objeto ByteArray especificado por el parámetro bytes y se escriben en el ByteArray de destino comenzando desde la posición especificada en offset.

Parámetros

bytes:ByteArray — El objeto ByteArray en el que se leerán los datos.
 
offset:uint (default = 0) — La posición de desplazamiento en bytes en la que se deben escribir los datos de lectura.
 
length:uint (default = 0) — El número de bytes que se van a leer. El valor predeterminado 0 hace que se lean todos los datos disponibles.


Emite
EOFError — No hay datos suficientes disponibles para leer.
 
RangeError — El valor del desplazamiento suministrado y la longitud, combinados, es mayor que el máximo para un uint.

readDouble

()método 
public function readDouble():Number

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un número de coma flotante (64 bits) con precisión doble IEEE 754 del flujo de bytes.

Valor devuelto
Number — Número de coma flotante (64 bits) con precisión doble.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readFloat

()método 
public function readFloat():Number

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un número de coma flotante (32 bits) con precisión simple IEEE 754 del flujo de bytes.

Valor devuelto
Number — Número de coma flotante (32 bits) con precisión simple.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readInt

()método 
public function readInt():int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un entero de 32 bits con signo del flujo de bytes.

El valor devuelto se encuentra entre -2147483648 y 2147483647.

Valor devuelto
int — Entero de 32 bits con signo entre -2147483648 y 2147483647.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readMultiByte

()método 
public function readMultiByte(length:uint, charSet:String):String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee una cadena multibyte de longitud especificada desde la transmisión de bytes mediante el juego de caracteres especificado.

Parámetros

length:uint — El número de bytes del flujo de bytes que se va a leer.
 
charSet:String — La cadena que denota el juego de caracteres que se utilizará para interpretar los bytes. Las posibles cadenas del conjunto de caracteres puden ser "shift-jis", "cn-gb", "iso-8859-1" y otras. Para obtener una lista completa, consulte los juegos de caracteres admitidos.

Nota: si el sistema actual no reconoce el parámetro charSet, la aplicación utiliza la página de códigos predeterminada del sistema como conjunto de caracteres. Por ejemplo, un valor para el parámetro charSet, como en myTest.readMultiByte(22, "iso-8859-01") que utiliza 01 en lugar de 1 podría funcionar en el equipo de desarrollo, pero no en otro equipo. En el otro sistema, la aplicación utilizará la página de códigos predeterminada del sistema.

Valor devuelto
String — Cadena con codificación UTF-8.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readObject

()método 
public function readObject():*

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un objeto del conjunto de bytes, codificado en formato serializado AMF.

Valor devuelto
* — El objeto deserializado.

Emite
EOFError — No hay datos suficientes disponibles para leer.

Elementos de API relacionados

readShort

()método 
public function readShort():int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un entero de 16 bits con signo del flujo de bytes.

El valor devuelto se encuentra entre -32768 y 32767.

Valor devuelto
int — Entero de 16 bits con signo entre -32768 y 32767.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readUnsignedByte

()método 
public function readUnsignedByte():uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un byte sin signo del flujo de bytes.

El valor devuelto se encuentra entre 0 y 255.

Valor devuelto
uint — Entero de 32 bits sin signo entre 0 y 255.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readUnsignedInt

()método 
public function readUnsignedInt():uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un entero de 32 bits sin signo del flujo de bytes.

El valor devuelto se encuentra entre 0 y 4294967295.

Valor devuelto
uint — Entero de 32 bits sin signo entre 0 y 4294967295.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readUnsignedShort

()método 
public function readUnsignedShort():uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee un entero de 16 bits sin signo del flujo de bytes.

El valor devuelto se encuentra entre 0 y 65535.

Valor devuelto
uint — Entero de 16 bits sin signo entre 0 y 65535.

Emite
EOFError — No hay datos suficientes disponibles para leer.

readUTF

()método 
public function readUTF():String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee una cadena UTF-8 del flujo de bytes. Se da por hecho que la cadena tiene un prefijo de declaración unsigned short que indica la longitud en bytes.

Valor devuelto
String — Cadena con codificación UTF-8.

Emite
EOFError — No hay datos suficientes disponibles para leer.

Elementos de API relacionados

readUTFBytes

()método 
public function readUTFBytes(length:uint):String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Lee una secuencia de bytes UTF-8 especificada por el parámetro length desde el flujo de bytes y devuelve una cadena.

Parámetros

length:uint — Declaración unsigned short que indica la longitud de los bytes UTF-8.

Valor devuelto
String — Cadena compuesta por los bytes UTF-8 de la longitud especificada.

Emite
EOFError — No hay datos suficientes disponibles para leer.

toJSON

()método 
public function toJSON(k:String):*

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 11, AIR 3, Flash Lite 4

Proporciona un método anulable para personalizar la codificación JSON de valores de un objeto ByteArray.

El método JSON.stringify() busca un método toJSON() en cada objeto que atraviesa. Si el método toJSON() se encuentra, JSON.stringify() lo llama para cada valor que encuentra, transfiriendo la tecla que está emparejada con el valor.

ByteArray proporciona una implementación predeterminada de toJSON() que simplemente devuelve el nombre de la clase. Dado que el contenido de cualquier ByteArray requiere interpretación, los clientes que deseen exportar objetos ByteArray a JSON deben proporcionar su propia implementación. Para ello, puede redefinir el método toJSON() en el prototipo de la clase.

El método toJSON() puede devolver un valor de cualquier tipo. Si devuelve un objeto, stringify() se repite en el objeto. Si toJSON() devuelve una cadena, stringify() no se repite y continúa su recorrido.

Parámetros

k:String — La clave de un par clave/valor que JSON.stringify() ha encontrado en su recorrido por este objeto

Valor devuelto
* — La cadena del nombre de la clase.

Elementos de API relacionados

toString

()método 
public function toString():String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Convierte el conjunto de bytes en una cadena. Si los datos del conjunto comienzan con una marca de orden de byte Unicode, la aplicación conserva dicha marca al convertirla en una cadena. Si System.useCodePage se define como true, la aplicación trata los datos del conjunto como si estuvieran en la página de códigos del sistema actual durante la conversión.

Valor devuelto
String — Representación de cadena del conjunto de bytes.

uncompress

()método 
public function uncompress(algorithm:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Descomprime la matriz de bytes. Después de la llamada, la propiedad length de ByteArray se establece con la nueva longitud. La propiedad position está establecida en 0.

El conjunto de bytes debe estar comprimido con el mismo algoritmo que la descompresión. Especifica un algoritmo de descompresión transfiriendo un valor (definido en la clase CompressionAlgorithm) como el parámetro algorithm. Los algoritmos admitidos son los siguientes:

El formato de datos comprimidos zlib se describe en http://www.ietf.org/rfc/rfc1950.txt.

El algoritmo de compresión deflate se describ en http://www.ietf.org/rfc/rfc1951.txt.

El algoritmo de compresión lzma se describe en http://www.7-zip.org/7z.html.

Para poder descodificar datos comprimidos en formatos de archivo que utilicen el algoritmo de compresión deflate, por ejemplo, datos en formato gzip o zip, no basta con llamar a uncompress(CompressionAlgorithm.DEFLATE) en un conjunto ByteArray que contenga datos con ese formato de compresión. Primero se deben separar los metadatos que forman parte del formato de datos comprimidos de los datos actuales. Para obtener más información, consulte la descripción del método compress().

Parámetros

algorithm:String (default = NaN) — El algoritmo de compresión empleado durante la descompresión. Debe ser el mismo algoritmo de compresión que se utilizó para comprimir los datos. Los valores válidos se definen como constantes en la clase CompressionAlgorithm. La opción predeterminada es utilizar el formato zlib. El soporte para el algoritmo lzma se añadió en Flash Player 11.3 y AIR 3.3. Debe tener dichas versiones del reproductor o una versión posterior para poder utilizar lzma.


Emite
IOError — Los datos no son datos comprimidos válidos; no se comprimieron con el mismo algoritmo de compresión.

Elementos de API relacionados

writeBoolean

()método 
public function writeBoolean(value:Boolean):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un valor booleano. Se escribe un solo byte según el parámetro value, 1 si es true o 0 si es false.

Parámetros

value:Boolean — Valor booleano que determina el byte que se escribe. Si el parámetro es true, el método escribe un 1; si es false, el método escribe un 0.

writeByte

()método 
public function writeByte(value:int):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un byte en el flujo de bytes.

Se utilizan los 8 bits más bajos del parámetro. Los 24 bits más altos se omiten.

Parámetros

value:int — Entero de 32 bits. Los 8 bits más bajos se escriben en el flujo de bytes.

writeBytes

()método 
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe una secuencia de length bytes desde el conjunto de bytes especificado, bytes, comenzando por offset (índice basado en cero) bytes en el flujo de bytes.

Si se omite el parámetro length, se utiliza la longitud predeterminada de 0; el método escribe todo el búfer comenzando por offset. Si también se omite el parámetro offset, se escribirá en todo el búfer.

Si offset o length está fuera de rango, se ajustarán para que coincidan con el principio y el final del conjunto bytes.

Parámetros

bytes:ByteArray — Objeto ByteArray.
 
offset:uint (default = 0) — Índice basado en cero que indica la posición del conjunto en el que se comenzará a escribir.
 
length:uint (default = 0) — Un entero sin signo que indica la profundidad del búfer en el que se escribirá.

writeDouble

()método 
public function writeDouble(value:Number):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un número de coma flotante (64 bits) con precisión doble IEEE 754 en el flujo de bytes.

Parámetros

value:Number — Número de coma flotante (64 bits) con precisión doble.

writeFloat

()método 
public function writeFloat(value:Number):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un número de coma flotante (32 bits) con precisión simple IEEE 754 en el flujo de bytes.

Parámetros

value:Number — Número de coma flotante (32 bits) con precisión simple.

writeInt

()método 
public function writeInt(value:int):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un entero de 32 bits con signo en el flujo de bytes.

Parámetros

value:int — Entero que se escribe en el flujo de bytes.

writeMultiByte

()método 
public function writeMultiByte(value:String, charSet:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe una cadena multibyte en el flujo de bytes mediante el juego de caracteres especificado.

Parámetros

value:String — El valor de la cadena que se va a escribir.
 
charSet:String — Cadena que denota el conjunto de caracteres que se va a utilizar. Las posibles cadenas del conjunto de caracteres puden ser "shift-jis", "cn-gb", "iso-8859-1" y otras. Para obtener una lista completa, consulte los juegos de caracteres admitidos.

writeObject

()método 
public function writeObject(object:*):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un objeto en el conjunto de bytes en formato serializado AMF.

Parámetros

object:* — Objeto que se va a serializar.

Elementos de API relacionados

writeShort

()método 
public function writeShort(value:int):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un entero de 16 bits en el flujo de bytes. Se utilizan los 16 bits más bajos del parámetro. Los 16 bits más altos se omiten.

Parámetros

value:int — Entero de 32 bits, cuyos 16 bits más bajos se escriben en el flujo de bytes.

writeUnsignedInt

()método 
public function writeUnsignedInt(value:uint):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe un entero de 32 bits sin signo en el flujo de bytes.

Parámetros

value:uint — Entero sin signo que se escribe en el flujo de bytes.

writeUTF

()método 
public function writeUTF(value:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe una cadena UTF-8 en el flujo de bytes. La longitud de la cadena UTF-8 (expresada en bytes) se escribe primero, como un entero de 16 bits, seguida de los bytes que representan los caracteres de la cadena.

Parámetros

value:String — El valor de la cadena que se va a escribir.


Emite
RangeError — Si la longitud es superior a 65535.

writeUTFBytes

()método 
public function writeUTFBytes(value:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Escribe una cadena UTF-8 en el flujo de bytes. Similar al método writeUTF(), pero writeUTFBytes() no añade un prefijo a la cadena con una palabra de 16 bits de longitud.

Parámetros

value:String — El valor de la cadena que se va a escribir.

ByteArrayExample.as

En el ejemplo siguiente, se utiliza la clase ByteArrayExample para escribir un valor booleano y la representación de coma flotante con precisión doble de pi en un conjunto de bytes. Esto se consigue con los pasos siguientes:
  1. Declare una nueva instancia del objeto ByteArray byteArr.
  2. Escriba el valor equivalente a bytes del valor booleano false y, a continuación, compruebe la longitud y vuélvalo a leer.
  3. Escriba el equivalente de coma flotante con precisión doble del valor matemático de pi.
  4. Vuelva a leer cada uno de los nueves bytes escritos en el conjunto de bytes.

Nota: si trace() se llama en un byte, imprime el equivalente decimal de los bytes almacenados en el conjunto de bytes.

Observe que se añade un segmento de código al final para comprobar errores al final del archivo para garantizar que el flujo de bytes no se lea más allá de su final.

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 ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.