| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die IDataOutput-Schnittstelle bietet eine Reihe von Methoden zum Schreiben von Binärdaten. Diese Schnittstelle ist das E/A-Gegenstück zur IDataInput-Schnittstelle, mit der Binärdaten gelesen werden. Die IDataOutput-Schnittstelle wird von den Klassen Socket und ByteArray implementiert.
Alle IDataInput- und IDataOutput-Vorgänge erfolgen in der Standardeinstellung im Format "bigEndian" (das höchstwertige Byte der Folge wird an der niedrigsten bzw. ersten Speicheradresse gespeichert) und ungeblockt.
Vorzeichenerweiterung ist nur beim Lesen von Daten relevant, jedoch nicht beim Schreiben. Sie benötigen deshalb keine unterschiedlichen Schreibmethoden für die Datentypen IDataInput.readUnsignedByte() und IDataInput.readUnsignedShort(). Dies bedeutet:
- Verwenden Sie
IDataOutput.writeByte() mit IDataInput.readUnsignedByte() und IDataInput.readByte().
- Verwenden Sie
IDataOutput.writeShort() mit IDataInput.readUnsignedShort() und IDataInput.readShort().
Beispiele anzeigen
endian:String [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die Bytereihenfolge der Daten. Entweder die Konstante für "bigEndian" oder für "littleEndian" der Endian-Klasse.
Implementierung
public function get endian():String
public function set endian(value:String):void
Siehe auch
objectEncoding:uint [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Anhand dieses Werts wird ermittelt, ob beim Schreiben oder Lesen von Binärdaten 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):void
Siehe auch
public function writeBoolean(value:Boolean):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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 Flash Player eine 1. Bei false wird eine 0 geschrieben.
|
public function writeByte(value:int):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt ein Byte. Es werden die unteren 8 Bit des Parameters verwendet. Die oberen 24 Bit werden ignoriert.
Parameter
| value:int — Ein Byte-Wert als Ganzzahl.
|
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt eine Bytefolge der Länge length aus dem angegebenen Byte-Array bytes ab der Position offset (auf null basierender Index) in den Byte-Datenstrom.
Wird der Parameter length weggelassen, wird die Standardlänge 0 verwendet. Flash Player 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 zu schreibende Byte-Array.
|
| |
| offset:uint (default = 0) |
| |
| length:uint (default = 0) |
public function writeDouble(value:Number):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit (64 Bit).
Parameter
| value:Number — Eine Gleitkommazahl mit doppelter Genauigkeit (64 Bit).
|
public function writeFloat(value:Number):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit (32 Bit).
Parameter
| value:Number — Eine Gleitkommazahl mit einfacher Genauigkeit (32 Bit).
|
public function writeInt(value:int):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt eine vorzeichenbehaftete 32-Bit-Ganzzahl.
Parameter
| value:int — Ein Byte-Wert als vorzeichenbehaftete Ganzzahl.
|
public function writeMultiByte(value:String, charSet:String):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes in den Byte-Datenstrom.
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.
|
public function writeObject(object:*):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt ein Objekt im serialisierten AMF-Format in den Byte-Datenstrom oder das Byte-Array.
Parameter
| object:* — Das zu serialisierende Objekt.
|
Siehe auch
public function writeShort(value:int):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt eine 16-Bit-Ganzzahl. Es werden die unteren 16 Bit des Parameters verwendet. Die oberen 16 Bit werden ignoriert.
Parameter
| value:int — Ein Byte-Wert als Ganzzahl.
|
public function writeUnsignedInt(value:uint):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt eine vorzeichenlose 32-Bit-Ganzzahl.
Parameter
| value:uint — Ein Byte-Wert als vorzeichenlose Ganzzahl.
|
public function writeUTF(value:String):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt einen UTF-8-String in den Byte-Datenstrom. 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
public function writeUTFBytes(value:String):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Schreibt einen UTF-8-String. Entspricht writeUTF(), doch dem String wird kein 16-Bit-Wort mit der Längenangabe vorangestellt.
Parameter
| value:String — Der String-Wert, der geschrieben werden soll.
|
Im folgenden Beispiel werden mit der Klasse
DataOutputExample ein boolescher Ausdruck und die Gleitkommadarstellung (mit doppelter Genauigkeit) der Zahl Pi in ein Byte-Array 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 und die Gleitkommadarstellung (mit doppelter Genauigkeit) der Zahl Pi.
- Rufen Sie den booleschen Wert und den Gleitkommawert ab.
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 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.
}
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 2:03 AM GMT-07:00
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/utils/IDataOutput.html
