Pacchettoflash.utils
Interfacciapublic interface IDataOutput
ImplementatoriByteArray, Socket

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:

Vedere gli esempi

Vedere anche

Interfaccia IDataInput
endian
Socket, classe
URLStream, classe
ByteArray, classe


Proprietà pubbliche
 ProprietàDefinito da
  endian: String
L'ordine dei byte dei dati: costante "bigEndian" o "littleEndian" della classe Endian.
IDataOutput
  objectEncoding: uint
Utilizzato per stabilire quale formato utilizzare (ActionScript 3.0, ActionScript 2.0 o ActionScript 1.0) per scrivere o leggere dati binari.
IDataOutput
Metodi pubblici
 MetodoDefinito da
  
Scrive un valore booleano.
IDataOutput
  
writeByte(value:int):void
Scrive un byte.
IDataOutput
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Scrive una sequenza di byte (del numero indicato dal parametro lunghezza) dall'array di byte specificato (byte), a partire dal numero di byte pari a offset (numero intero a base zero) nel flusso di byte.
IDataOutput
  
Scrive un numero a virgola mobile IEEE 754 a precisione doppia (64 bit).
IDataOutput
  
Scrive un numero a virgola mobile IEEE 754 a precisione singola (32 bit).
IDataOutput
  
writeInt(value:int):void
Scrive un numero intero con segno a 32 bit.
IDataOutput
  
writeMultiByte(value:String, charSet:String):void
Scrive una stringa multibyte in un flusso di byte utilizzando il set di caratteri specificato.
IDataOutput
  
writeObject(object:*):void
Scrive un oggetto nel flusso o nell'array di byte nel formato serializzato AMF.
IDataOutput
  
Scrive un numero intero a 16 bit.
IDataOutput
  
Scrive un numero intero senza segno a 32 bit.
IDataOutput
  
Scrive una stringa UTF-8 nel flusso di byte.
IDataOutput
  
Scrive una stringa UTF-8.
IDataOutput
Descrizione delle proprietà
endianproprietà
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

objectEncodingproprietà 
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

Descrizione dei metodi
writeBoolean()metodo
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.

writeByte()metodo 
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.

writeBytes()metodo 
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.

writeDouble()metodo 
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).

writeFloat()metodo 
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).

writeInt()metodo 
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.

writeMultiByte()metodo 
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.

writeObject()metodo 
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

writeShort()metodo 
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.

writeUnsignedInt()metodo 
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.

writeUTF()metodo 
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
RangeError — La lunghezza supera 65535.
writeUTFBytes()metodo 
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.

Esempi Come utilizzare gli esempi
DataOutputExample.as

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:
  1. Dichiarare una nuova istanza dell'oggetto ByteArray byteArr.
  2. Scrivere l'equivalente in byte del valore booleano false e l'equivalente a virgola mobile e precisione doppia del valore matematico di pi.
  3. 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.
            }
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/utils/IDataOutput.html