Paqueteflash.utils
Interfazpublic interface IDataOutput
ImplementadoresByteArray, Socket

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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 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:

Ver los ejemplos

Véase también

Interfaz IDataInput
endian
Clase Socket
Clase URLStream
Clase ByteArray


Propiedades públicas
 PropiedadDefinido por
  endian : String
El orden de bytes de los datos; la constante "bigEndian" o "littleEndian" de la clase Endian.
IDataOutput
  objectEncoding : uint
Se utiliza para determinar si se debe emplear el formato ActionScript 3.0, ActionScript 2.0 o ActionScript 1.0 al escribir o leer datos binarios.
IDataOutput
Métodos públicos
 MétodoDefinido por
  
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 length desde la matriz de bytes especificada, bytes, comenzando por bytes offset (índice basado en cero) en el flujo de bytes.
IDataOutput
  
Escribe un número de coma flotante (64 bits) con precisión doble IEEE 754.
IDataOutput
  
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
Escribe una cadena multibyte en el flujo de bytes mediante el juego de caracteres especificado.
IDataOutput
  
writeObject(object:*):void
Escribe un objeto en el flujo de bytes o la matriz de bytes en formato serializado AMF.
IDataOutput
  
Escribe un entero de 16 bits.
IDataOutput
  
Escribe un entero de 32 bits sin signo.
IDataOutput
  
Escribe una cadena UTF-8 en el flujo de bytes.
IDataOutput
  
Escribe una cadena UTF-8.
IDataOutput
Información sobre propiedades
endianpropiedad
endian:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El orden de bytes de los datos; la constante "bigEndian" o "littleEndian" de la clase Endian.


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

Véase también

objectEncodingpropiedad 
objectEncoding:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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


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

Véase también

Información sobre métodos
writeBoolean()método
public function writeBoolean(value:Boolean):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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 Flash Player escribe un 1; si es false, Flash Player escribe un 0.

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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Escribe un byte. Se utilizan los 8 bits más bajos del parámetro. Los 24 bits más 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
Versión del reproductor: Flash Player 9

Escribe una secuencia de length bytes desde la matriz de bytes especificada, 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; Flash Player escribe en todo el búfer comenzando por 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 de la matriz bytes.

Parámetros

bytes:ByteArray — Matriz de bytes que se va a escribir.
 
offset:uint (default = 0) — Índice basado en cero que indica la posición de la matriz en la 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
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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 pueden 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
Versión del reproductor: Flash Player 9

Escribe un objeto en el flujo de bytes o la matriz de bytes en formato serializado AMF.

Parámetros

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

Véase también

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

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Escribe un entero de 16 bits. Se utilizan los 16 bits más bajos del parámetro. Los 16 bits más 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
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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 los ejemplos
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 una matriz 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 el equivalente de coma flotante con precisión doble del valor matemático de pi.
  3. 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.
            }
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/utils/IDataOutput.html