Nombre d'octets de données pouvant être lus à partir de la position actuelle dans le tableau d'octets et jusqu'à la fin de ce tableau.

Utilisez la propriété bytesAvailable conjointement avec les méthodes de lecture chaque fois que vous accédez à un objet ByteArray pour vous assurer que les données lues sont valides.

Indique l’encodage d’objet par défaut que doit utiliser la classe ByteArray pour une nouvelle occurrence de ByteArray. Lorsque vous créez une nouvelle occurrence de ByteArray, l’encodage correspondant débute par la valeur de defaultObjectEncoding. La propriété defaultObjectEncoding est initialisée à ObjectEncoding.AMF3.

Lorsqu’un objet est écrit ou lu dans des données binaires, la valeur objectEncoding permet de déterminer le format à utiliser : ActionScript 3.0, ActionScript 2.0 ou ActionScript 1.0. La valeur est une constante extraite de la classe ObjectEncoding.

Voir aussi

Modifie ou lit l’ordre des octets des données (« bigEndian » ou « littleEndian »). Les valeurs supportées sont des constantes extraites de la classe Endian.

Voir aussi

Longueur de l’objet ByteArray, en octets.

Si la longueur est réglée sur une valeur supérieure à la longueur en cours, Flash Player remplit l'espace laissé à droite avec des zéros.

Si la longueur est réglée sur une valeur inférieure à la longueur en cours, le tableau est tronqué.

Permet de déterminer le format à utiliser (ActionScript 3.0, ActionScript 2.0 ou ActionScript 1.0) pour l’écriture ou la lecture d'une occurrence ByteArray. La valeur est une constante extraite de la classe ObjectEncoding.

Voir aussi

Déplace le pointeur de fichier dans l’objet ByteArray ou en renvoie la position actuelle, en octets. Il s'agit de l’endroit où le prochain appel d’une méthode de lecture ou d’écriture démarre l’opération.

Crée une occurrence de ByteArray qui représente un tableau d’octets contracté, afin de vous permettre d'utiliser les méthodes et propriétés de cette classe pour optimiser les flux et le stockage de vos données.

Compresse le tableau d'octets au format de données compressé zlib. Tout le tableau d’octets est compressé.

Après l'appel, la propriété length de l'objet ByteArray est définie sur la nouvelle longueur. La propriété position est définie à la fin du tableau d'octets.

Le format de données compressé zlib est décrit à l'adresse http://www.ietf.org/rfc/rfc1950.txt.

Voir aussi

Lit une valeur booléenne dans le flux d’octets. Un seul octet est lu, et la valeur true est renvoyée s'il n'est pas nul, false dans le cas contraire.

Lit un octet signé dans le flux d’octets.

La valeur renvoyée est comprise entre -128 et 127.

Lit le nombre d’octets de données spécifié par le paramètre length dans le flux d’octets. Les octets sont lus dans l'objet ByteArray spécifié par le paramètre bytes, et les octets sont écrits dans l'objet ByteArray cible en commençant à la position spécifiée par offset.

Paramètres

Lit un nombre à virgule flottante à deux décimales (64 bits), conforme à IEEE 754, dans le flux d’octets.

Lit un nombre à virgule flottante à une décimale (32 bits), conforme à IEEE 754, dans le flux d’octets.

Lit un entier de 32 bits signé dans le flux d’octets.

La valeur renvoyée est comprise entre -2147483648 et 2147483647.

Lit une chaîne à plusieurs octets de longueur spécifiée à partir du flux d'octets et à l'aide du jeu de caractères désigné.

Paramètres

Lit dans le flux d'octets un objet codé au format AMF (Action Message Format) sérialisé.

Lit un entier de 16 bits signé dans le flux d’octets.

La valeur renvoyée est comprise entre -32768 et 32767.

Lit un octet non signé dans le flux d’octets.

La valeur renvoyée est comprise entre 0 et 255.

Lit un entier de 32 bits non signé dans le flux d’octets.

La valeur renvoyée est comprise entre 0 et 4294967295.

Lit un entier de 16 bits non signé dans le flux d’octets.

La valeur renvoyée est comprise entre 0 et 65535.

Lit une chaîne UTF-8 dans le flux d'octets. La chaîne doit être précédée d'un caractère non signé indiquant la longueur en octets.

Voir aussi

Lit une séquence d'octets UTF-8 spécifiée par le paramètre length dans le flux d'octets et renvoie une chaîne.

Paramètres

Convertit le tableau d’octets en chaîne. Si les données du tableau débutent par une marque d’ordre d’octet Unicode, Flash la respecte lors de la conversion en chaîne. Si System.useCodePage est défini sur true, Flash Player traite les données du tableau comme si elles figuraient dans l'actuelle page de codes système lors de la conversion.

Décompresse le tableau d’octets. Le tableau d'octets doit avoir été compressé au format zlib.

Après l'appel, la propriété length de l'objet ByteArray est définie sur la nouvelle longueur. La propriété position est définie sur 0.

Le format de données compressé zlib est décrit à l'adresse http://www.ietf.org/rfc/rfc1950.txt.

Voir aussi

Ecrit une valeur booléenne. Un seul octet est écrit, conformément au paramètre value, soit 1 si true ou 0 si false.

Paramètres

Ecrit un octet dans le flux d’octets.

Les 8 bits inférieurs du paramètre sont utilisés. Les 24 bits supérieurs ne sont pas pris en compte.

Paramètres

Ecrit une séquence d’octets length extraits du tableau d'octets bytes, en démarrant aux octets offset (index à base zéro) dans le flux d'octets.

Si le paramètre length est omis, la longueur par défaut est utilisée. Flash Player écrit tout le contenu de la mémoire tampon à partir de offset. Si le paramètre offset est également omis, toute la mémoire tampon est écrite.

Si les paramètres offset et length sont hors limites, ils sont réglés sur le début et la fin du tableau (bytes).

Paramètres

Ecrit un nombre à virgule flottante à deux décimales (64 bits), conforme à IEEE 754, dans le flux d’octets.

Paramètres

Ecrit un nombre à virgule flottante à une décimale (32 bits) et conforme à IEEE 754 dans le flux d’octets.

Paramètres

Ecrit un entier de 32 bits signé dans le flux d'octets.

Paramètres

Ecrit une chaîne à plusieurs octets dans le flux d’octets en utilisant le jeu de caractères spécifié.

Paramètres

Ecrit un objet dans le tableau d'octets au format AMF sérialisé.

Paramètres

Ecrit un entier de 16 bits dans le flux d'octets. Les 16 bits inférieurs du paramètre sont utilisés. Les 16 bits supérieurs ne sont pas pris en compte.

Paramètres

Ecrit un entier de 32 bits non signé dans le flux d'octets.

Paramètres

Ecrit une chaîne UTF-8 dans le flux d'octets. La longueur de la chaîne UTF-8 exprimée en octets est d'abord écrite sous forme d’entier de 16 bits, suivi des octets représentant les caractères de la chaîne.

Paramètres

Ecrit une chaîne UTF-8 dans le flux d'octets. Comme writeUTF(), mais la méthode writeUTFBytes() n’insère pas dans la chaîne un préfixe correspondant à un mot de 16 bits.

Paramètres

1. Déclarez une nouvelle occurrence de l'objet byteArr.
2. Ecrivez la valeur équivalente en octets de la valeur booléenne false, puis vérifiez la longueur et relisez-la.
3. Ecrivez la valeur à virgule flottante à double décimale de la valeur mathématique de pi.
4. Relisez chacun des neuf octets écrits dans le tableau d'octets.

Remarque : lorsque la méthode trace() est appelée sur un octet, elle imprime l'équivalent décimal des octets stockés dans le tableau d'octets.

Vous remarquerez qu'un segment de code est ajouté à la fin pour vérifier les erreurs de fin de fichier et s'assurer que la lecture du flux d’octets ne dépasse pas la fin.

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