ByteArray  - AS3

Die Anzahl der ab der aktuellen Position im Bytearray bis zum Ende des Arrays zum Lesen verfügbaren Datenbyte.

Verwenden Sie bei jedem Zugriff auf ein ByteArray-Objekt die bytesAvailable-Eigenschaft zusammen mit den Lesemethoden, um sicherzustellen, dass gültige Daten gelesen werden.

Gibt die Standardkodierung für Objekte der ByteArray-Klasse an, die für neue ByteArray-Instanzen verwendet wird. Beim Erstellen einer neuen ByteArray-Instanz beginnt die Kodierung für diese Instanz mit dem Wert von defaultObjectEncoding. Die Eigenschaft defaultObjectEncoding wird auf ObjectEncoding.AMF3 initialisiert.

Beim Schreiben oder Lesen eines Objekts aus Binärdaten wird anhand des Werts von objectEncoding ermittelt, ob als Format ActionScript 3.0, ActionScript 2.0 oder ActionScript 1.0 verwendet wird. Der Wert ist eine Konstante der ObjectEncoding-Klasse.

Verwandte API-Elemente

Ändert oder liest die Bytereihenfolge für die Daten; entweder Endian.BIG_ENDIAN oder Endian.LITTLE_ENDIAN. Der Standardwert lautet BIG_ENDIAN.

Verwandte API-Elemente

Die Länge des ByteArray-Objekts in Byte.

Wenn die Länge auf einen Wert eingestellt wird, der größer als die aktuelle Länge ist, wird die rechte Seite des Byte-Arrays mit Nullen gefüllt.

Wenn für die Länge ein Wert angegeben wird, der kleiner als die aktuelle Länge ist, wird das Bytearray abgeschnitten.

Anhand dieses Werts wird ermittelt, ob beim Schreiben oder Lesen einer ByteArray-Instanz als Format ActionScript 3.0, ActionScript 2.0 oder ActionScript 1.0 verwendet werden soll. Der Wert ist eine Konstante der ObjectEncoding-Klasse.

Verwandte API-Elemente

Bewegt den Dateizeiger im ByteArray-Objekt oder gibt dessen aktuelle Position in Byte zurück. Dies ist die Position, ab der beim nächsten Aufruf einer Lese- oder Schreibmethode Daten gelesen bzw. geschrieben werden.

Gibt an, ob der zugrunde liegende Arbeitsspeicher des Bytearrays shareable ist, also gemeinsam genutzt werden kann. Für ein gemeinsam nutzbares Bytearray verwenden alle ByteArray-Instanzen in allen Workern, die auf das Bytearray verweisen, denselben zugrunde liegenden Systemspeicher. Der Standardwert ist false, was bedeutet, dass der zugrunde liegende Speicher nicht gemeinsam von Workern genutzt wird.

Diese Eigenschaft beeinflusst auch, was die Laufzeitumgebung mit diesem Bytearray macht, wenn es mit der Worker.setSharedProperty()-Methode oder der MessageChannel.send()-Methode an einen Worker übergeben wird:

• Nicht gemeinsam genutzt: Wenn diese Eigenschaft den Wert false hat und das Bytearray an einen Worker übergeben wird, erstellt die Laufzeitumgebung eine vollständige Kopie des Bytearrays und weist ein neues Segment des Speichers zu, in dem der Inhalt des doppelten Bytearrays gespeichert wird
• Gemeinsam genutzt: Wenn diese Eigenschaft den Wert true hat und das Bytearray an einen Worker übergeben wird, verwendet die Laufzeitumgebung denselben zugrunde liegenden Arbeitsspeicher als Speicherpuffer für den Inhalt der ursprünglichen ByteArray-Instanz und der neuen ByteArray-Instanz, die für den zweiten Worker erstellt wurde. Im Wesentlichen enthalten beide ByteArray-Instanzen einen Verweis auf dasselbe zugrunde liegende Bytearray.

Die Möglichkeit, dass mehrere Worker gleichzeitig auf ein gemeinsam genutztes Bytearray zugreifen, kann zu der unerwünschten Situation führen, dass beide Worker zur gleichen Zeit mit dem zugrunde liegenden Speicher des Bytearrays arbeiten. Sie können den Zugriff auf den gemeinsam genutzten Speicher mit verschiedenen Mechanismen steuern:

• mit den Vergleich-und-Austausch-Mechanismen, die von den Methoden atomicCompareAndSwapIntAt() und atomicCompareAndSwapLength() der ByteArray-Klasse bereitgestellt werden
• mit den spezialisierten Mechanismen, die von den Mutex- und Condition-Klassen (im flash.concurrent-Paket) bereitgestellt werden

Das Einstellen dieser Eigenschaft auf true betrifft nur nachfolgenden Code, der dieses Bytearray an einen Worker übergibt. Alle Kopien dieses Bytearrays, die bereits an einen Worker übergeben wurden, bleiben weiterhin als separate Kopie vorhanden.

Wenn Sie diese Eigenschaft auf false setzen, nachdem sie zuvor den Wert true hatte, wird der zugrunde liegende Speicher für das Bytearray sofort in ein neues Segment des Systemspeichers kopiert. Diese ByteArray-Instanz verwendet ab dann den neuen zugrunde liegenden Speicher. Folglich wird der zugrunde liegende Speicher dieses Bytearrays nicht mehr mit anderen Workern gemeinsam genutzt, auch wenn dies zuvor der Fall war. Wenn Sie dieses Bytearray anschließend an einen Worker übergeben, wird sein zugrunde liegender Speicher kopiert wie bei jedem ByteArray-Objekt, dessen shareable-Eigenschaft auf false eingestellt ist.

Der Standardwert ist false.

Verwandte API-Elemente

Erstellt eine ByteArray-Instanz, die ein gepacktes Bytearray darstellt, damit Sie die Methoden und Eigenschaften dieser Klasse einsetzen können, um die Datenspeicherung und den Datenstrom Ihres Programms zu optimieren.

Vergleicht in einer einzigen atomarischen Operation einen Ganzzahlwert in diesem Bytearray mit einem anderen Ganzzahlwert und tauscht diese Bytes bei Übereinstimmung durch einen anderen Wert aus.

Diese Methode soll mit einem Bytearray verwendet werden, dessen zugrunde liegender Speicher von mehreren Workern gemeinsam genutzt wird (die shareable-Eigenschaft der ByteArray-Instanz ist true). Es werden nacheinander die folgenden Schritte ausgeführt:

1. Liest einen Ganzzahlwert aus diesem Bytearray bei dem Index (in Bytes), der im byteIndex-Argument angegeben ist
2. Vergleicht den tatsächlichen Wert aus diesem Bytearray mit dem Wert, der im expectedValue-Argument übergeben wurde
3. Wenn die beiden Werte übereinstimmen, wird der Wert im newValue-Argument in das Bytearray geschrieben, und zwar an der Position, die durch den byteIndex-Parameter angegeben wird. Es wird der Wert zurückgegeben, der sich zuvor bei diesen Bytes befand (der in Schritt 1 gelesene Wert)
4. Andernfalls wird der Inhalt des Bytearrays nicht geändert und die Methode gibt den tatsächlichen Wert zurück, der aus dem Bytearray gelesen wurde

Diese Schritte werden in einer atomarischen Hardwaretransaktion ausgeführt. Auf diese Weise wird sichergestellt, dass keine Operationen von anderen Workern während der Vergleich-und-Austausch-Operation den Inhalt des Bytearrays ändern.

Parameter

Verwandte API-Elemente

In einer einzelnen atomarischen Operation wird die Länge des Bytearrays mit einem angegebenen Wert verglichen und bei Übereinstimmung geändert.

Diese Methode soll mit einem Bytearray verwendet werden, dessen zugrunde liegender Speicher von mehreren Workern gemeinsam genutzt wird (die shareable-Eigenschaft der ByteArray-Instanz ist true). Folgendes wird ausgeführt:

1. Die length-Eigenschaft (Ganzzahl) der ByteArray-Instanz wird gelesen
2. Die Länge wird mit dem im expectedLength-Argument übergebenen Wert verglichen
3. Wenn die beiden Werte übereinstimmen, wird die Länge des Bytearrays auf den Wert geändert, der als newLength-Parameter übergeben wurde, sodass die Größe des Bytearrays entweder zunimmt oder abnimmt
4. Andernfalls wird das Bytearray nicht geändert

Diese Schritte werden in einer atomarischen Hardwaretransaktion ausgeführt. Auf diese Weise wird sichergestellt, dass keine Operationen von anderen Workern während der Vergleich-und-Größenänderung-Operation den Inhalt des Bytearrays ändern.

Parameter

Verwandte API-Elemente

Löscht den Inhalt des Bytearrays und setzt die length- und position-Eigenschaft auf 0 zurück. Wenn diese Methode aufgerufen wird, wird explizit Speicher freigegeben, der von der ByteArray-Instanz verwendet wird.

Komprimiert das Bytearray. Das gesamte Bytearray wird komprimiert. Nach dem Aufruf wird die Eigenschaft length des ByteArray auf die neue Länge eingestellt. Die Eigenschaft position wird auf das Ende des Byte-Arrays eingestellt.

Sie legen einen Komprimierungsalgorithmus fest, indem Sie einen Wert (definiert in der CompressionAlgorithm-Klasse) als algorithm-Parameter übergeben. Folgende Algorithmen werden unterstützt:

Eine Beschreibung des komprimierten Datenformats zlib finden Sie unter http://www.ietf.org/rfc/rfc1950.txt.

Eine Beschreibung des Komprimierungsalgorithmus deflate finden Sie unter http://www.ietf.org/rfc/rfc1951.txt.

Der lzma-Komprimierungsalgorithmus wird unter http://www.7-zip.org/7z.html beschrieben.

Der deflate-Komprimierungsalgorithmus wird in verschiedenen Komprimierungsformaten verwendet, zum Beispiel zlib, gzip, einige zip-Implementierungen. Wenn Daten in einem dieser Formate komprimiert werden, enthalten Komprimierungsformatdaten (zum Beispiel die .zip-Datei), neben der komprimierten Version der Originaldaten auch Metadaten. Zu dieses Metadaten, die in verschiedenen Dateiformaten enthalten sind, gehören unter anderem Dateiname, Datum und Uhrzeit der Dateiänderung, ursprüngliche Dateigröße, optionale Kommentare und Prüfsummendaten.

Wenn zum Beispiel ein ByteArray mit dem zlib-Algorithmus komprimiert wird, weist das resultierende ByteArray eine bestimmte Struktur auf. Bestimmte Byte enthalten Metadaten zu den komprimierten Daten, während andere Byte die komprimierte Version der ursprünglichen ByteArray-Daten enthalten. Gemäß der Formatspezifikation für komprimierte Daten im zlib-Format werden diese Byte (der Teil, der die komprimierte Version der Originaldaten enthält) mit dem deflate-Algorithmus komprimiert. Folglich sind diese Byte identisch mit dem Ergebnis, das beim Aufrufen von compress(airCompressionAlgorithm.DEFLATE) auf dem ursprünglichen ByteArray zurückgegeben wird. Das Ergebnis von compress(air.CompressionAlgorithm.ZLIB) enthält jedoch auch die Metadaten, während das Ergebnis von compress(CompressionAlgorithm.DEFLATE) nur die komprimierte Version der ursprünglichen ByteArray-Daten enthält.

Um das deflate-Format zum Komprimieren der Daten einer ByteArray-Instanz in einem bestimmten Format wie z. B. gzip oder zip zu verwenden, können Sie nicht einfach compress(CompressionAlgorithm.DEFLATE) aufrufen. Sie müssen ein ByteArray erstellen, das gemäß der Spezifikation des Komprimierungsformats strukturiert ist, einschließlich der jeweiligen Metadaten sowie der komprimierten Daten, die Sie mit dem deflate-Format erhalten. Um in einem bestimmten Format (z. B. gzip oder zip) komprimierte Daten zu decodieren, genügt es nicht, einfach uncompress(CompressionAlgorithm.DEFLATE) für diese Daten aufzurufen. Sie müssen zunächst die Metadaten von den komprimierten Daten trennen. Dann können Sie das deflate-Format verwenden, um die Daten zu dekomprimieren.

Parameter

Verwandte API-Elemente

Komprimiert das Bytearray unter Verwendung des deflate-Komprimierungsalgorithmus. Das gesamte Bytearray wird komprimiert.

Nach dem Aufruf wird die Eigenschaft length des ByteArray auf die neue Länge eingestellt. Die Eigenschaft position wird auf das Ende des Byte-Arrays eingestellt.

Eine Beschreibung des Komprimierungsalgorithmus deflate finden Sie unter http://www.ietf.org/rfc/rfc1951.txt.

Um das deflate-Format zum Komprimieren der Daten einer ByteArray-Instanz in einem bestimmten Format wie z. B. gzip oder zip zu verwenden, können Sie nicht einfach deflate() aufrufen. Sie müssen ein ByteArray erstellen, das gemäß der Spezifikation des Komprimierungsformats strukturiert ist, einschließlich der jeweiligen Metadaten sowie der komprimierten Daten, die Sie mit dem deflate-Format erhalten. Analog hierzu können Sie zum Dekodieren von Daten, die in einem Format wie z. B. gzip oder zip komprimiert sind, nicht einfach inflate() für diese Daten aufrufen. Sie müssen zunächst die Metadaten von den komprimierten Daten trennen. Dann können Sie das deflate-Format verwenden, um die Daten zu dekomprimieren.

Verwandte API-Elemente

Dekomprimiert das Bytearray unter Verwendung des deflate-Komprimierungsalgorithmus. Das ByteArray muss mit demselben Komprimierungsalgorithmus komprimiert worden sein.

Nach dem Aufruf wird die Eigenschaft length des ByteArray auf die neue Länge eingestellt. Die position-Eigenschaft wird auf 0 gesetzt.

Eine Beschreibung des Komprimierungsalgorithmus deflate finden Sie unter http://www.ietf.org/rfc/rfc1951.txt.

Um Daten zu dekodieren, die in einem Format komprimiert sind, das den deflate-Komprimierungsalgorithmus verwendet (z. B. Daten im GZIP- oder ZIP-Format) kann nicht einfach inflate() auf einem ByteArray, das die Daten im komprimierten Format enthält, aufgerufen werden. Sie müssen zunächst die Metadaten, die als Teil des komprimierten Datenformats enthalten sind, von den tatsächlichen komprimierten Daten trennen. Weitere Informationen finden Sie in der Beschreibung der compress()-Methode.

Verwandte API-Elemente

Liest einen booleschen Wert vom Bytedatenstream. Es wird ein einzelnes Byte gelesen und true zurückgegeben, wenn das Byte ungleich 0 ist, oder andernfalls false.

Liest ein vorzeichenbehaftetes Byte vom Bytedatenstream.

Der Rückgabewert liegt im Bereich von -128 bis 127.

Liest die Anzahl der im Parameter length angegebenen Datenbyte aus dem Bytestrom. Die Byte werden in das ByteArray-Objekt gelesen, das vom Parameter bytes angegeben wird, und in das Ziel-ByteArray geschrieben, das an der durch offset festgelegten Position beginnt.

Parameter

Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit (64 Bit) vom Bytedatenstream.

Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit (32 Bit) vom Bytedatenstream.

Liest eine vorzeichenbehaftete 32-Bit-Ganzzahl vom Bytedatenstream.

Der Rückgabewert liegt im Bereich von -2147483648 bis 2147483647.

Liest einen Multibyte-String der angegebenen Länge unter Verwendung des angegebenen Zeichensatzes vom Bytedatenstream.

Parameter

Liest ein Objekt vom Bytedatenstream, das im serialisierten AMF-Format kodiert ist.

Verwandte API-Elemente

Liest eine vorzeichenbehaftete 16-Bit-Ganzzahl vom Bytedatenstream.

Der Rückgabewert liegt im Bereich von -32768 bis 32767.

Liest ein vorzeichenloses Byte vom Bytedatenstream.

Der Rückgabewert liegt im Bereich von 0 bis 255.

Liest eine vorzeichenlose 32-Bit-Ganzzahl vom Bytedatenstream.

Der Rückgabewert liegt im Bereich von 0 bis 4294967295.

Liest eine vorzeichenlose 16-Bit-Ganzzahl vom Bytedatenstream.

Der Rückgabewert liegt im Bereich von 0 bis 65535.

Liest einen UTF-8-String vom Bytedatenstream. Es wird davon ausgegangen, dass dem String eine short-Ganzzahl ohne Vorzeichen mit der Länge in Byte vorangestellt ist.

Verwandte API-Elemente

Liest eine Folge von UTF-8-Byte, die vom length-Parameter angegeben ist, aus dem Bytedatenstream und gibt einen String zurück.

Parameter

Stellt eine überschreibbare Methode zum Anpassen der JSON-Kodierung von Werten in einem ByteArray-Objekt bereit.

Die JSON.stringify()-Methode sucht bei jedem Objekt, das untersucht wird, nach einer toJSON()-Methode. Wenn die toJSON()-Methode gefunden wird, ruft JSON.stringify() diese für jeden gefundenen Wert auf und übergibt dabei den Schlüssel, der diesem Wert zugeordnet ist.

ByteArray stellt eine standardmäßige Implementierung von toJSON() bereit, die einfach den Namen der Klasse zurückgibt. Da der Inhalt eines jeden ByteArray interpretiert werden muss, müssen Kunden, die ByteArray-Objekte nach JSON exportieren möchten, ihre eigene Implementierung bereitstellen. Dazu können Sie die toJSON()-Methode für den Klassenprototyp neu definieren.

Die toJSON()-Methode kann einen Wert eines beliebigen Typs zurückgeben. Wenn sie ein Objekt zurückgibt, führt stringify() eine Rekursion in dieses Objekt aus. Wenn toJSON() einen String zurückgibt, führt stringify() keine Rekursion aus und setzt die Untersuchung fort.

Parameter

Verwandte API-Elemente

Konvertiert das Bytearray in einen String. Wenn die Daten im Array mit einer Unicode-Bytereihenfolgenkennung beginnen, wird diese von der Anwendung bei der Konvertierung in einen String berücksichtigt. Wenn System.useCodePage auf true gesetzt ist, behandelt die Anwendung die Daten im Array beim Konvertieren, als lägen sie in der Kodierung der Codepage des Systems vor.

Dekomprimiert das Bytearray. Nach dem Aufruf wird die Eigenschaft length des ByteArray auf die neue Länge eingestellt. Die position-Eigenschaft wird auf 0 gesetzt.

Das ByteArray muss mit demselben Komprimierungsalgorithmus wie die Dekomprimierung komprimiert worden sein. Sie legen einen Dekomprimierungsalgorithmus fest, indem Sie einen Wert (definiert in der CompressionAlgorithm-Klasse) als algorithm-Parameter übergeben. Folgende Algorithmen werden unterstützt:

Eine Beschreibung des komprimierten Datenformats zlib finden Sie unter http://www.ietf.org/rfc/rfc1950.txt.

Eine Beschreibung des Komprimierungsalgorithmus deflate finden Sie unter http://www.ietf.org/rfc/rfc1951.txt.

Der lzma-Komprimierungsalgorithmus wird unter http://www.7-zip.org/7z.html beschrieben.

Um Daten zu dekodieren, die in einem Format komprimiert wurden, das den deflate-Komprimierungsalgorithmus verwendet (z. B. gzip oder zip), genügt es nicht, uncompress(CompressionAlgorithm.DEFLATE) für ein ByteArray mit den komprimierten Daten aufzurufen. Sie müssen zunächst die Metadaten, die als Teil des komprimierten Datenformats enthalten sind, von den tatsächlichen komprimierten Daten trennen. Weitere Informationen finden Sie in der Beschreibung der compress()-Methode.

Parameter

Verwandte API-Elemente

Schreibt einen booleschen Wert. Entsprechend dem Parameter value wird ein einzelnes Byte geschrieben: 1, wenn der Wert true ist oder 0, wenn der Wert false ist.

Parameter

Schreibt ein Byte in den Bytedatenstream.

Es werden die unteren 8 Bit des Parameters verwendet. Die oberen 24 Bit werden ignoriert.

Parameter

Schreibt eine Bytefolge der Länge length aus dem angegebenen Bytearray bytes ab der Position offset (auf null basierender Index) in den Bytedatenstream.

Wird der Parameter length weggelassen, wird die Standardlänge 0 verwendet. Die Methode schreibt den gesamten Puffer ab der Position offset. Wird auch der Parameter offset weggelassen, so wird der gesamte Pufferinhalt geschrieben.

Wenn sich die Parameter offset bzw. length außerhalb des gültigen Bereichs befinden, werden sie auf den Anfang bzw. auf das Ende des bytes-Array gesetzt.

Parameter

Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit (64 Bit) in den Bytedatenstream.

Parameter

Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit (32 Bit) in den Bytedatenstream.

Parameter

Schreibt eine vorzeichenbehaftete 32-Bit-Ganzzahl in den Bytedatenstream.

Parameter

Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes in den Bytedatenstream.

Parameter

Schreibt ein Objekt im serialisierten AMF-Format in den Bytedatenstream.

Parameter

Verwandte API-Elemente

Schreibt eine 16-Bit-Ganzzahl in den Bytedatenstream. Es werden die unteren 16 Bit des Parameters verwendet. Die oberen 16 Bit werden ignoriert.

Parameter

Schreibt eine vorzeichenlose 32-Bit-Ganzzahl in den Bytedatenstream.

Parameter

Schreibt einen UTF-8-String in den Bytedatenstream. Die Länge des UTF-8-Strings in Byte als 16-Bit-Ganzzahl wird zuerst geschrieben, gefolgt von den Byte für die Zeichen des Strings.

Parameter

Schreibt einen UTF-8-String in den Bytedatenstream. Entspricht der writeUTF()-Methode, doch bei writeUTFBytes() wird dem String kein 16-Bit-Wort mit der Längenangabe vorangestellt.

Parameter

1. Deklarieren Sie eine neue ByteArray-Objektinstanz mit dem Namen byteArr.
2. Schreiben Sie den Byte-Äquivalenzwert des booleschen Werts false, prüfen Sie die Länge, und rufen Sie den Wert anschließend ab.
3. Schreiben Sie den Äquivalenzwert der Zahl Pi in Gleitkommadarstellung (mit doppelter Genauigkeit).
4. Rufen Sie die neun einzelnen Byte im Bytearray ab.

Hinweis: Wenn trace() für ein Byte aufgerufen wird, wird der äquivalente Dezimalwert der Byte aus dem Bytearray gedruckt.

Am Ende wird ein Codesegment eingefügt, mit dem auf Dateiende-Fehler geprüft wird. Hiermit wird sichergestellt, dass nicht über das Ende des Bytestroms hinaus gelesen wird.

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