IDataOutput - Referencia de la API de Adobe ActionScript® 3 (AS3 )

Paquete	flash.utils
Interfaz	public interface IDataOutput
Implementadores	ByteArray, FileStream, Socket

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

La interfaz IDataOutput proporciona un conjunto de métodos para la escritura de datos binarios. Esta interfaz es la contrapartida E/S de la interfaz IDataInput, que lee datos binarios. La interfaz IDataOutput se implementa mediante las clases FileStream, Socket y ByteArray.

Todas las operaciones de IDataInput y IDataOutput son, de forma predeterminada, "bigEndian" (el byte más significativo de la secuencia se almacena en la primera dirección de almacenamiento o en la inferior) y no producen bloqueo.

El signo de la extensión es relevante sólo al leer datos, no al escribirlos. Por tanto, no es necesario disponer de métodos de escritura independientes para poder trabajar con IDataInput.readUnsignedByte() y IDataInput.readUnsignedShort(). En otras palabras:

Utilice IDataOutput.writeByte() con IDataInput.readUnsignedByte() y IDataInput.readByte().
Utilice IDataOutput.writeShort() con IDataInput.readUnsignedShort() y IDataInput.readShort().

Ver los ejemplos

Elementos de API relacionados

Interfaz IDataInput
endian
Clase FileStream
Clase Socket
Clase URLStream
Clase ByteArray

Propiedades públicas

	Propiedad		Definido por
		endian : String El orden de bytes de los datos; la constante BIG_ENDIAN o LITTLE_ENDIAN de la clase Endian.	IDataOutput
		objectEncoding : uint Se usa para determinar si al escribir o leer datos binarios con el método writeObject() se utiliza el formato AMF3 o AMF0.	IDataOutput

Métodos públicos

	Método		Definido por
		writeBoolean(value:Boolean):void Escribe un valor booleano.	IDataOutput
		writeByte(value:int):void Escribe un byte.	IDataOutput
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Escribe una secuencia de bytes desde el conjunto de bytes especificado (bytes). Comienza desde el byte especificado por offset (con un índice basado en cero) con una longitud especificada por length, en el flujo de archivos, el flujo de bytes o el conjunto de bytes.	IDataOutput
		writeDouble(value:Number):void Escribe un número de coma flotante (64 bits) con precisión doble IEEE 754.	IDataOutput
		writeFloat(value:Number):void Escribe un número de coma flotante (32 bits) con precisión simple IEEE 754.	IDataOutput
		writeInt(value:int):void Escribe un entero de 32 bits con signo.	IDataOutput
		writeMultiByte(value:String, charSet:String):void Se escribe una cadena multi-byte en el flujo del archivo, de bytes o en el conjunto de bytes, utilizando el conjunto de caracteres especificado.	IDataOutput
		writeObject(object:*):void Escribe un objeto en el flujo del archivo, de bytes o en el conjunto de bytes, en formato serializado AMF.	IDataOutput
		writeShort(value:int):void Escribe un entero de 16 bits.	IDataOutput
		writeUnsignedInt(value:uint):void Escribe un entero de 32 bits sin signo.	IDataOutput
		writeUTF(value:String):void Escribe una cadena UTF-8 en el flujo del archivo, de bytes o en el conjunto de bytes.	IDataOutput
		writeUTFBytes(value:String):void Escribe una cadena UTF-8.	IDataOutput

Información sobre propiedades

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

El orden de bytes de los datos, la constante BIG_ENDIAN o LITTLE_ENDIAN de la clase Endian.

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

Elementos de API relacionados

Clase Endian

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 usa para determinar si al escribir o leer datos binarios con el método writeObject() se utiliza el formato AMF3 o AMF0. 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

IDataInput.readObject()
writeObject()
Clase ObjectEncoding

Información sobre métodos

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, se escribe 1; si es false, se escribe 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. Se utilizan los 8 bits más bajos del parámetro; los 24 bits altos se omiten.

Parámetros

value:int — Un valor de byte como un entero.

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 bytes desde el conjunto de bytes especificado (bytes). Comienza desde el byte especificado por offset (con un índice basado en cero) con una longitud especificada por length, en el flujo de archivos, el flujo de bytes o el conjunto de bytes.

Si se omite el parámetro length, se utiliza un valor predeterminado de length 0 y se escribe todo el búfer comenzando desde offset. Si también se omite el parámetro offset, se escribirá en todo el búfer.

Si el parámetro offset o length está fuera de rango, se ajustarán al principio y al final del conjunto bytes.

Parámetros

	`bytes:ByteArray` — Conjunto de bytes que se va a escribir.

	`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.

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.

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.

Parámetros

value:int — Valor de byte como un entero con signo.

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

Se escribe una cadena multi-byte en el flujo del archivo, de bytes o en el conjunto de bytes, utilizando el conjunto 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 flujo del archivo, de bytes o en el conjunto de bytes, en formato serializado AMF.

Parámetros

object:* — El objeto que se va a serializar.

Elementos de API relacionados

objectEncoding
flash.net.registerClassAlias()

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. Se utilizan los 16 bits más bajos del parámetro; los 16 bits altos se omiten.

Parámetros

value:int — Un valor de byte como un entero.

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.

Parámetros

value:uint — Valor de byte como un entero sin signo.

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 del archivo, de bytes o en el conjunto 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. Similar a writeUTF(), pero 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.

Ejemplos Cómo utilizar este ejemplo

DataOutputExample.as

En el ejemplo siguiente, se utiliza la clase DataOutputExample 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:

Declare una nueva instancia del objeto ByteArray byteArr.
Escriba el valor equivalente a bytes del valor booleano false y el equivalente de coma flotante con precisión doble del valor matemático de pi.
Vuelva a leer el valor booleano y el número de coma flotante con precisión doble.

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 DataOutputExample extends Sprite {        
        public function DataOutputExample() {
            var byteArr:ByteArray = new ByteArray();

            byteArr.writeBoolean(false);
            byteArr.writeDouble(Math.PI);
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean()); // false
            } 
            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.
            }
        }
    }
}

Avisos legales | Política de privacidad en línea

IDataOutput - AS3

Clases x

endian

objectEncoding

writeBoolean

writeByte

writeBytes

writeDouble

writeFloat

writeInt

writeMultiByte

writeObject

writeShort

writeUnsignedInt

writeUTF

writeUTFBytes