| Paket | flash.utils |
| Klasse | public class ByteArray |
| Vererbung | ByteArray  Object |
| Implementiert | IDataInput, IDataOutput |
| Unterklassen | ByteArrayAsset |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Hinweis: Die ByteArray-Klasse ist für fortgeschrittene Entwickler bestimmt, die Datenzugriff auf Byteebene benötigen.
Im Speicher abgelegte Daten sind in einem Bytearray angeordnet (die kompakteste Darstellung des Datentyps), doch eine Instanz der ByteArray-Klasse kann mit dem Standardoperator [] (Array-Zugriff) bearbeitet werden. Sie kann auch als im Speicher abgelegte Datei gelesen und geschrieben werden. Die dazu verwendeten Methoden entsprechen denen der Klassen URLStream und Socket.
Zusätzlich werden die zlib-, deflate- und lzma-Komprimierung und -Dekomprimierung sowie die Objektserialisierung im AMF-Format (Action Message Format) unterstützt.
Ein ByteArray-Objekt kann seinen Sicherungsarbeitsspeicher mit mehreren Workern teilen, wenn Sie seine shareable-Eigenschaft auf true einstellen.
Einsatzmöglichkeiten der ByteArray-Klasse:
- Erstellen eines benutzerdefinierten Protokolls für die Verbindung mit einem Server
- Programmieren eines benutzerdefinierten URLEncoder/URLDecoder
- Programmieren eines benutzerdefinierten AMF/Remoting-Pakets
- Optimieren der verwendeten Datengröße durch das Verwenden von Datentypen
- Arbeiten mit binären Daten, die aus einer Datei geladen wurden.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| bytesAvailable : uint [schreibgeschützt]
Die Anzahl der ab der aktuellen Position im Bytearray bis zum Ende des Arrays zum Lesen verfügbaren Datenbyte. | ByteArray | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| defaultObjectEncoding : uint [statisch]
Gibt die Standardkodierung für Objekte der ByteArray-Klasse an, die für neue ByteArray-Instanzen verwendet wird. | ByteArray | ||
| endian : String
Ändert oder liest die Bytereihenfolge für die Daten; entweder Endian.BIG_ENDIAN oder Endian.LITTLE_ENDIAN. | ByteArray | ||
| length : uint
Die Länge des ByteArray-Objekts in Byte. | ByteArray | ||
| objectEncoding : uint
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. | ByteArray | ||
| position : uint
Bewegt den Dateizeiger im ByteArray-Objekt oder gibt dessen aktuelle Position in Byte zurück. | ByteArray | ||
| shareable : Boolean
Gibt an, ob der zugrunde liegende Arbeitsspeicher des Bytearrays gemeinsam genutzt werden kann. | ByteArray | ||
| Methode | Definiert von | ||
|---|---|---|---|
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. | ByteArray | ||
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. | ByteArray | ||
In einer einzelnen atomarischen Operation wird die Länge des Bytearrays mit einem angegebenen Wert verglichen und bei Übereinstimmung geändert. | ByteArray | ||
Löscht den Inhalt des Bytearrays und setzt die length- und position-Eigenschaft auf 0 zurück. | ByteArray | ||
Komprimiert das Bytearray. | ByteArray | ||
Komprimiert das Bytearray unter Verwendung des deflate-Komprimierungsalgorithmus. | ByteArray | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
Dekomprimiert das Bytearray unter Verwendung des deflate-Komprimierungsalgorithmus. | ByteArray | ||
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Liest einen booleschen Wert vom Bytedatenstream. | ByteArray | ||
Liest ein vorzeichenbehaftetes Byte vom Bytedatenstream. | ByteArray | ||
Liest die Anzahl der im Parameter „length“ angegebenen Datenbyte aus dem Bytestrom. | ByteArray | ||
Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit (64 Bit) vom Bytedatenstream. | ByteArray | ||
Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit (32 Bit) vom Bytedatenstream. | ByteArray | ||
Liest eine vorzeichenbehaftete 32-Bit-Ganzzahl vom Bytedatenstream. | ByteArray | ||
Liest einen Multibyte-String der angegebenen Länge unter Verwendung des angegebenen Zeichensatzes vom Bytedatenstream. | ByteArray | ||
readObject():*
Liest ein Objekt vom Bytedatenstream, das im serialisierten AMF-Format kodiert ist. | ByteArray | ||
Liest eine vorzeichenbehaftete 16-Bit-Ganzzahl vom Bytedatenstream. | ByteArray | ||
Liest ein vorzeichenloses Byte vom Bytedatenstream. | ByteArray | ||
Liest eine vorzeichenlose 32-Bit-Ganzzahl vom Bytedatenstream. | ByteArray | ||
Liest eine vorzeichenlose 16-Bit-Ganzzahl vom Bytedatenstream. | ByteArray | ||
Liest einen UTF-8-String vom Bytedatenstream. | ByteArray | ||
Liest eine Folge von UTF-8-Byte, die vom length-Parameter angegeben ist, aus dem Bytedatenstream und gibt einen String zurück. | ByteArray | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
Stellt eine überschreibbare Methode zum Anpassen der JSON-Kodierung von Werten in einem ByteArray-Objekt bereit. | ByteArray | ||
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
Konvertiert das Bytearray in einen String. | ByteArray | ||
Dekomprimiert das Bytearray. | ByteArray | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
Schreibt einen booleschen Wert. | ByteArray | ||
Schreibt ein Byte in den Bytedatenstream. | ByteArray | ||
Schreibt eine Bytefolge der Länge „length aus dem angegebenen Bytearray „bytes“ ab Position „offset“ (auf null basierender Index) in den Bytestream. | ByteArray | ||
Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit (64 Bit) in den Bytedatenstream. | ByteArray | ||
Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit (32 Bit) in den Bytedatenstream. | ByteArray | ||
Schreibt eine vorzeichenbehaftete 32-Bit-Ganzzahl in den Bytedatenstream. | ByteArray | ||
Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes in den Bytedatenstream. | ByteArray | ||
Schreibt ein Objekt im serialisierten AMF-Format in den Bytedatenstream. | ByteArray | ||
Schreibt eine 16-Bit-Ganzzahl in den Bytedatenstream. | ByteArray | ||
Schreibt eine vorzeichenlose 32-Bit-Ganzzahl in den Bytedatenstream. | ByteArray | ||
Schreibt einen UTF-8-String in den Bytedatenstream. | ByteArray | ||
Schreibt einen UTF-8-String in den Bytedatenstream. | ByteArray | ||
bytesAvailable | Eigenschaft |
bytesAvailable:uint [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get bytesAvailable():uintdefaultObjectEncoding | Eigenschaft |
defaultObjectEncoding:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public static function get defaultObjectEncoding():uint public static function set defaultObjectEncoding(value:uint):voidVerwandte API-Elemente
endian | Eigenschaft |
endian:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ändert oder liest die Bytereihenfolge für die Daten; entweder Endian.BIG_ENDIAN oder Endian.LITTLE_ENDIAN. Der Standardwert lautet BIG_ENDIAN.
Implementierung
public function get endian():String public function set endian(value:String):voidVerwandte API-Elemente
length | Eigenschaft |
length:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get length():uint public function set length(value:uint):voidobjectEncoding | Eigenschaft |
objectEncoding:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get objectEncoding():uint public function set objectEncoding(value:uint):voidVerwandte API-Elemente
position | Eigenschaft |
position:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get position():uint public function set position(value:uint):voidshareable | Eigenschaft |
shareable:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11.5, AIR 3.5 |
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
falsehat 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
truehat 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()undatomicCompareAndSwapLength()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.
Implementierung
public function get shareable():Boolean public function set shareable(value:Boolean):voidVerwandte API-Elemente
ByteArray | () | Konstruktor |
public function ByteArray()| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
atomicCompareAndSwapIntAt | () | Methode |
public function atomicCompareAndSwapIntAt(byteIndex:int, expectedValue:int, newValue:int):int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11.5, AIR 3.5 |
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:
- Liest einen Ganzzahlwert aus diesem Bytearray bei dem Index (in Bytes), der im
byteIndex-Argument angegeben ist - Vergleicht den tatsächlichen Wert aus diesem Bytearray mit dem Wert, der im
expectedValue-Argument übergeben wurde - Wenn die beiden Werte übereinstimmen, wird der Wert im
newValue-Argument in das Bytearray geschrieben, und zwar an der Position, die durch denbyteIndex-Parameter angegeben wird. Es wird der Wert zurückgegeben, der sich zuvor bei diesen Bytes befand (der in Schritt 1 gelesene Wert) - 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
byteIndex:int — die Indexposition (in Bytes), von der die zu vergleichende Ganzzahl gelesen wird, und an die der newValue-Wert geschrieben wird, wenn der Vergleich eine Übereinstimmung ergibt. Der Wert muss ein Vielfaches von 4 sein.
| |
expectedValue:int — der Wert, der mit dem Inhalt des Bytearrays beim angegebenen Index übereinstimmen soll
| |
newValue:int — der neue Wert, der den Inhalt des Bytearrays beim angegebenen Index ersetzt, wenn der Vergleich eine Übereinstimmung ergibt
|
int — Der vorherige Wert an der angegebenen Position, falls der Vergleich eine Übereinstimmung ergibt, oder der tatsächliche Wert aus dem Bytearray, wenn der tatsächliche Wert und der erwartete Wert nicht übereinstimmen
|
Auslöser
ArgumentError — wenn der byteIndex-Wert nicht ein Vielfaches von 4 ist oder wenn er negativ ist
|
Verwandte API-Elemente
atomicCompareAndSwapLength | () | Methode |
public function atomicCompareAndSwapLength(expectedLength:int, newLength:int):int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11.5, AIR 3.5 |
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:
- Die
length-Eigenschaft (Ganzzahl) der ByteArray-Instanz wird gelesen - Die Länge wird mit dem im
expectedLength-Argument übergebenen Wert verglichen - 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 - 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
expectedLength:int — der erwartete Wert der length-Eigenschaft des ByteArray. Wenn der angegebene Wert und der erwartete Wert übereinstimmen, wird die Länge des Bytearrays geändert.
| |
newLength:int — der neue Wert der Länge für das Bytearray, falls der Vergleich erfolgreich ist
|
int — der vorherige length-Wert des ByteArray, unabhängig davon, ob er geändert wurde oder nicht
|
Verwandte API-Elemente
clear | () | Methode |
public function clear():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
compress | () | Methode |
public function compress(algorithm:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
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
algorithm:String (default = NaN)compress(CompressionAlgorithm.DEFLATE) hat den gleichen Effekt wie das Aufrufen der deflate()-Methode. Unterstützung für den lzma Algorithmus wurde für Flash Player 11.3 und AIR 3.3 hinzugefügt. Sie benötigen diese oder höhere Player-Versionen, um die lzma Komprimierung zu verwenden.
|
Verwandte API-Elemente
deflate | () | Methode |
public function deflate():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
inflate | () | Methode |
public function inflate():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 10 |
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.
Auslöser
IOError — Die Daten sind keine gültigen komprimierten Daten; sie wurden nicht mit demselben Komprimierungsalgorithmus dekomprimiert, der zum Komprimieren verwendet wurde.
|
Verwandte API-Elemente
readBoolean | () | Methode |
public function readBoolean():Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Boolean — Gibt true zurück, wenn das Byte ungleich 0 ist, andernfalls false.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readByte | () | Methode |
public function readByte():int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest ein vorzeichenbehaftetes Byte vom Bytedatenstream.
Der Rückgabewert liegt im Bereich von -128 bis 127.
Rückgabewerteint — Eine Ganzzahl zwischen -128 und 127.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readBytes | () | Methode |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
bytes:ByteArray — Das ByteArray-Objekt, in das die Daten gelesen werden.
| |
offset:uint (default = 0)bytes, ab dem die gelesenen Daten geschrieben werden sollten.
| |
length:uint (default = 0) |
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
| |
RangeError — Die kombinierten Werte für Länge und Offset sind größer als der Höchstwert für eine vorzeichenlose Ganzzahl.
|
readDouble | () | Methode |
public function readDouble():Number| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit (64 Bit) vom Bytedatenstream.
RückgabewerteNumber — Eine Gleitkommazahl mit doppelter Genauigkeit (64 Bit).
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readFloat | () | Methode |
public function readFloat():Number| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit (32 Bit) vom Bytedatenstream.
RückgabewerteNumber — Eine Gleitkommazahl mit einfacher Genauigkeit (32 Bit).
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readInt | () | Methode |
public function readInt():int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine vorzeichenbehaftete 32-Bit-Ganzzahl vom Bytedatenstream.
Der Rückgabewert liegt im Bereich von -2147483648 bis 2147483647.
Rückgabewerteint — Eine vorzeichenbehaftete 32-Bit-Ganzzahl zwischen -2147483648 und 2147483647.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readMultiByte | () | Methode |
public function readMultiByte(length:uint, charSet:String):String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest einen Multibyte-String der angegebenen Länge unter Verwendung des angegebenen Zeichensatzes vom Bytedatenstream.
Parameter
length:uint — Die Anzahl der aus dem Bytestream zu lesenden Byte.
| |
charSet:String — Der String, der den zum Interpretieren der Byte zu verwendenden Zeichensatz angibt. Mögliche Zeichensatz-Strings sind unter anderem "shift-jis", "cn-gb" und "iso-8859-1". Eine vollständige Liste finden Sie unter Unterstützte Zeichensätze.
Hinweis: Wird der Wert des |
String — Ein UTF-8-kodierter String.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readObject | () | Methode |
public function readObject():*| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest ein Objekt vom Bytedatenstream, das im serialisierten AMF-Format kodiert ist.
Rückgabewerte* — Das deserialisierte Objekt.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
Verwandte API-Elemente
readShort | () | Methode |
public function readShort():int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine vorzeichenbehaftete 16-Bit-Ganzzahl vom Bytedatenstream.
Der Rückgabewert liegt im Bereich von -32768 bis 32767.
Rückgabewerteint — Eine vorzeichenbehaftete 16-Bit-Ganzzahl zwischen -32768 und 32767.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readUnsignedByte | () | Methode |
public function readUnsignedByte():uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest ein vorzeichenloses Byte vom Bytedatenstream.
Der Rückgabewert liegt im Bereich von 0 bis 255.
Rückgabewerteuint — Eine vorzeichenlose 32-Bit-Ganzzahl zwischen 0 und 255.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readUnsignedInt | () | Methode |
public function readUnsignedInt():uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine vorzeichenlose 32-Bit-Ganzzahl vom Bytedatenstream.
Der Rückgabewert liegt im Bereich von 0 bis 4294967295.
Rückgabewerteuint — Eine vorzeichenlose 32-Bit-Ganzzahl zwischen 0 und 4294967295.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readUnsignedShort | () | Methode |
public function readUnsignedShort():uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine vorzeichenlose 16-Bit-Ganzzahl vom Bytedatenstream.
Der Rückgabewert liegt im Bereich von 0 bis 65535.
Rückgabewerteuint — Eine vorzeichenlose 16-Bit-Ganzzahl zwischen 0 und 65535.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
readUTF | () | Methode |
public function readUTF():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
RückgabewerteString — Ein UTF-8-kodierter String.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
Verwandte API-Elemente
readUTFBytes | () | Methode |
public function readUTFBytes(length:uint):String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine Folge von UTF-8-Byte, die vom length-Parameter angegeben ist, aus dem Bytedatenstream und gibt einen String zurück.
Parameter
length:uint — Ein vorzeichenloses short-Element mit der Länge des UTF-8-Strings.
|
String — Ein String der angegebenen Länge, der aus den UTF-8-Byte besteht.
|
Auslöser
EOFError — Es sind nicht genug zu lesende Daten vorhanden.
|
toJSON | () | Methode |
public function toJSON(k:String):*| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3, Flash Lite 4 |
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
k:String — Der Schlüssel eines Schlüssel/Wert-Paares, das JSON.stringify() beim Durchlaufen dieses Objekts gefunden hat
|
* — Der String mit dem Klassennamen.
|
Verwandte API-Elemente
toString | () | Methode |
public function toString():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
String — Die Stringdarstellung des Byte-Arrays.
|
uncompress | () | Methode |
public function uncompress(algorithm:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
algorithm:String (default = NaN) |
Auslöser
IOError — Die Daten sind keine gültigen komprimierten Daten; sie wurden nicht mit demselben Komprimierungsalgorithmus dekomprimiert, der zum Komprimieren verwendet wurde.
|
Verwandte API-Elemente
writeBoolean | () | Methode |
public function writeBoolean(value:Boolean):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
value:Boolean — Ein boolescher Wert, der angibt, welches Byte geschrieben wird. Ist der Parameter true, schreibt die Methode eine 1. Bei false wird eine 0 geschrieben.
|
writeByte | () | Methode |
public function writeByte(value:int):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schreibt ein Byte in den Bytedatenstream.
Es werden die unteren 8 Bit des Parameters verwendet. Die oberen 24 Bit werden ignoriert.
Parameter
value:int — Eine 32-Bit-Ganzzahl. Die niedrigstwertigen 8 Bit werden in den Bytedatenstream geschrieben.
|
writeBytes | () | Methode |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
bytes:ByteArray — Das ByteArray-Objekt.
| |
offset:uint (default = 0) | |
length:uint (default = 0) |
writeDouble | () | Methode |
public function writeDouble(value:Number):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit (64 Bit) in den Bytedatenstream.
Parameter
value:Number — Eine Gleitkommazahl mit doppelter Genauigkeit (64 Bit).
|
writeFloat | () | Methode |
public function writeFloat(value:Number):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit (32 Bit) in den Bytedatenstream.
Parameter
value:Number — Eine Gleitkommazahl mit einfacher Genauigkeit (32 Bit).
|
writeInt | () | Methode |
writeMultiByte | () | Methode |
public function writeMultiByte(value:String, charSet:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes in den Bytedatenstream.
Parameter
value:String — Der String-Wert, der geschrieben werden soll.
| |
charSet:String — Der String, der den zu verwendenden Zeichensatz angibt. Mögliche Zeichensatz-Strings sind unter anderem "shift-jis", "cn-gb" und "iso-8859-1". Eine vollständige Liste finden Sie unter Unterstützte Zeichensätze.
|
writeObject | () | Methode |
writeShort | () | Methode |
public function writeShort(value:int):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schreibt eine 16-Bit-Ganzzahl in den Bytedatenstream. Es werden die unteren 16 Bit des Parameters verwendet. Die oberen 16 Bit werden ignoriert.
Parameter
value:int — Eine 32-Bit-Ganzzahl, deren niedrigstwertige 16 Bit in den Bytedatenstream geschrieben werden.
|
writeUnsignedInt | () | Methode |
public function writeUnsignedInt(value:uint):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schreibt eine vorzeichenlose 32-Bit-Ganzzahl in den Bytedatenstream.
Parameter
value:uint — Eine vorzeichenlose Ganzzahl, die in den Bytedatenstream geschrieben werden soll.
|
writeUTF | () | Methode |
public function writeUTF(value:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
value:String — Der String-Wert, der geschrieben werden soll.
|
Auslöser
RangeError — Wenn die Länge größer als 65535 ist.
|
writeUTFBytes | () | Methode |
public function writeUTFBytes(value:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
value:String — Der String-Wert, der geschrieben werden soll.
|
ByteArrayExample ein boolescher Ausdruck und die Gleitkommadarstellung (mit doppelter Genauigkeit) der Zahl Pi in ein Bytearray geschrieben. Dies wird in den folgenden Schritten erreicht:
- Deklarieren Sie eine neue ByteArray-Objektinstanz mit dem Namen
byteArr. - Schreiben Sie den Byte-Äquivalenzwert des booleschen Werts
false, prüfen Sie die Länge, und rufen Sie den Wert anschließend ab. - Schreiben Sie den Äquivalenzwert der Zahl Pi in Gleitkommadarstellung (mit doppelter Genauigkeit).
- 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.
}
}
}
}
Tue Jun 12 2018, 10:04 AM Z