| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
L'interfaccia IDataOutput fornisce una serie di metodi per la scrittura dei dati binari. Questa interfaccia è la controparte I/O dell'interfaccia IDataInput, che legge dati binari. L'interfaccia IDataOutput è implementata dalle classi Socket e ByteArray.
Tutte le operazioni IDataInput e IDataOutput sono "bigEndian" per impostazione predefinita (il byte più significativo della sequenza viene memorizzato nel primo/più basso indirizzo di archiviazione) e non bloccano il sistema.
L'estensione Sign ha importanza solo per la lettura dei dati, non per la scrittura. Per questo motivo, non è necessario separare i metodi di scrittura per utilizzare IDataInput.readUnsignedByte() e IDataInput.readUnsignedShort(). In altre parole:
- Utilizzare
IDataOutput.writeByte() con IDataInput.readUnsignedByte() e IDataInput.readByte().
- Utilizzare
IDataOutput.writeShort() con IDataInput.readUnsignedShort() e IDataInput.readShort().
Vedere gli esempi
endian:String [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
L'ordine dei byte dei dati: costante "bigEndian" o "littleEndian" della classe Endian.
Implementazione
public function get endian():String
public function set endian(value:String):void
Vedere anche
objectEncoding:uint [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Utilizzato per stabilire quale formato utilizzare (ActionScript 3.0, ActionScript 2.0 o ActionScript 1.0) per scrivere o leggere dati binari. Questo valore è una costante della classe ObjectEncoding.
Implementazione
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Vedere anche
public function writeBoolean(value:Boolean):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un valore booleano. Viene scritto un singolo byte a seconda del parametro value: 1 se true oppure 0 se false.
Parametri
| value:Boolean — Un valore booleano che determina il byte da scrivere. Se il parametro è true, Flash Player scrive 1; se è false, scrive 0.
|
public function writeByte(value:int):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un byte. Vengono utilizzati i 8 bit bassi del parametro. I 24 bit alti vengono ignorati.
Parametri
| value:int — Un valore byte come un numero intero.
|
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive una sequenza di byte length dall'array di byte specificato, bytes, avviando i byte offset (numero intero a base zero) nel flusso di byte.
Se il parametro length viene omesso, viene utilizzata la lunghezza predefinita 0 e Flash Player scrive l'intero buffer partendo da offset. Se viene omesso anche il parametro offset, viene scritto l'intero buffer.
Se il parametro offset o length è fuori intervallo, viene fissato all'inizio e alla fine dell'array bytes.
Parametri
| bytes:ByteArray — L'array di byte da scrivere.
|
| |
| offset:uint (default = 0) — Un numero intero a base zero, che indica la posizione dell'array da cui viene avviata la scrittura.
|
| |
| length:uint (default = 0) — Un numero intero senza segno, che indica fin dove scrivere nel buffer.
|
public function writeDouble(value:Number):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un numero a virgola mobile IEEE 754 a precisione doppia (64 bit).
Parametri
| value:Number — Un numero a virgola mobile a precisione doppia (64 bit).
|
public function writeFloat(value:Number):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un numero a virgola mobile IEEE 754 a precisione singola (32 bit).
Parametri
| value:Number — Un numero a virgola mobile a precisione singola (32 bit).
|
public function writeInt(value:int):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un numero intero con segno a 32 bit.
Parametri
| value:int — Un valore byte come un numero intero con segno.
|
public function writeMultiByte(value:String, charSet:String):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive una stringa multibyte in un flusso di byte utilizzando il set di caratteri specificato.
Parametri
| value:String — Il valore stringa da scrivere.
|
| |
| charSet:String — La stringa che indica il set di caratteri da utilizzare. Le stringhe dei set di caratteri possono essere "shift-jis", "cn-gb", "iso-8859-1" e altre. Per un elenco completo, vedere Set di caratteri supportati.
|
public function writeObject(object:*):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un oggetto nel flusso o nell'array di byte nel formato serializzato AMF.
Parametri
| object:* — L'oggetto da serializzare
|
Vedere anche
public function writeShort(value:int):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un numero intero a 16 bit. Vengono utilizzati i 16 bit bassi del parametro. I 16 bit alti vengono ignorati.
Parametri
| value:int — Un valore byte come un numero intero.
|
public function writeUnsignedInt(value:uint):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive un numero intero senza segno a 32 bit.
Parametri
| value:uint — Un valore byte come un numero intero senza segno.
|
public function writeUTF(value:String):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive una stringa UTF-8 nel flusso di byte. La lunghezza della stringa UTF-8 in byte viene scritta per prima, come numero intero a 16 bit, seguita dai byte che rappresentano i caratteri della stringa.
Parametri
| value:String — Il valore stringa da scrivere.
|
Genera
public function writeUTFBytes(value:String):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Scrive una stringa UTF-8. È simile a writeUTF(), ma non inserisce come prefisso della stringa una parola di 16 bit.
Parametri
| value:String — Il valore stringa da scrivere.
|
L'esempio seguente utilizza la classe
DataOutputExample per scrivere un valore booleano e la rappresentazione di pi a virgola mobile e a precisione doppia in un array di byte. Questa operazione viene eseguita mediante la procedura seguente:
- Dichiarare una nuova istanza dell'oggetto ByteArray
byteArr.
- Scrivere l'equivalente in byte del valore booleano
false e l'equivalente a virgola mobile e precisione doppia del valore matematico di pi.
- Leggere il valore booleano e il numero a virgola mobile e precisione doppia.
Si noti che alla fine viene aggiunto un segmento di codice per verificare la presenza di errori di fine del file e assicurare che il flusso di byte non venga letto oltre il suo punto finale.
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, 3:14 AM GMT-07:00
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/utils/IDataOutput.html