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

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.

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.

Véase también

Cambia o lee el orden de bytes para los datos "bigEndian" o "littleEndian". Los valores son constantes de la clase Endian.

Véase también

Longitud del objeto ByteArray, expresada en bytes.

Si la longitud se define como valor superior a la longitud actual, Flash Player rellena el lado derecho con ceros.

Si la longitud se define como valor inferior a la longitud actual, la matriz se trunca.

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.

Véase también

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.

Crea una instancia de ByteArray que representa una matriz empaquetada 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.

Comprime la matriz de bytes con el formato de datos comprimidos zlib. Se comprime toda la matriz 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 de la matriz de bytes.

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

Véase también

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.

Lee un byte con signo del flujo de bytes.

El valor devuelto se encuentra entre -128 y 127.

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

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

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

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

El valor devuelto se encuentra entre -2147483648 y 2147483647.

Lee una cadena multibyte de longitud especificada desde el flujo de bytes mediante el juego de caracteres especificado.

Parámetros

Lee un objeto de la matriz de bytes, codificado en formato serializado AMF.

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

El valor devuelto se encuentra entre -32768 y 32767.

Lee un byte sin signo del flujo de bytes.

El valor devuelto se encuentra entre 0 y 255.

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

El valor devuelto se encuentra entre 0 y 4294967295.

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

El valor devuelto se encuentra entre 0 y 65535.

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.

Véase también

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

Parámetros

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

Descomprime la matriz de bytes. La matriz de bytes debe haberse comprimido con el formato de datos comprimidos zlib.

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

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

Véase también

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

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

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 offset o length está fuera de rango, se ajustarán para que coincidan con el principio y el final de la matriz bytes.

Parámetros

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

Parámetros

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

Parámetros

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

Parámetros

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

Parámetros

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

Parámetros

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

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

Parámetros

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

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

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 la matriz de bytes.

Nota: si trace() se llama en un byte, imprime el equivalente decimal de los bytes almacenados en la matriz 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.
            }
        }
    }
}