FileStream  - AS3

Gibt für die zum Lesen verfügbaren Daten im Eingabepuffer die Anzahl der Byte an. Aus dem Programmcode der Benutzer muss bytesAvailable aufgerufen werden, um sicherzustellen, dass genügend Daten verfügbar sind, bevor diese mit einer der Lesemethoden gelesen werden.

Die Bytereihenfolge der Daten. Entweder die Konstante BIG_ENDIAN oder LITTLE_ENDIAN der Endian-Klasse.

Gibt an, ob das Format AMF3 oder AMF0 verwendet wird, wenn binäre Daten mit der readObject()-Methode gelesen oder der writeObject()-Methode geschrieben werden.

Der Wert ist eine Konstante der ObjectEncoding-Klasse. Standardmäßig wird das Format AMF3 verwendet.

Verwandte API-Elemente

Die aktuelle Position in der Datei.

Dieser Wert wird auf eine der folgenden Weise geändert:

• Wenn Sie die Eigenschaft ausdrücklich festlegen
• Wenn aus dem FileStream-Objekt gelesen wird (mit einer der Lesemethoden)
• Wenn in das FileStream-Objekt geschrieben wird

Die Position wird als Number (nicht als uint) definiert, um Dateien mit einer Länge von mehr als 2³² Byte zu unterstützen. Der Wert dieser Eigenschaft ist immer eine ganze Zahl unter 2⁵³. Wenn Sie diesen Wert auf eine Zahl mit Dezimalstellen einstellen, wird der Wert auf die nächste ganze Zahl abgerundet.

Wenn die position-Eigenschaft beim asynchronen Lesen einer Datei festgelegt wird, beginnt die Anwendung, den Lesepuffer mit den Daten ab der angegebenen Position zu füllen und die bytesAvailable-Eigenschaft kann auf 0 gesetzt werden. Warten Sie auf ein complete-Ereignis, bevor Sie eine read-Methode zum Lesen der Daten verwenden oder warten Sie auf ein progress-Ereignis und überprüfen Sie die bytesAvailable-Eigenschaft, bevor Sie eine read-Methode verwenden.

import flash.fileSystem.*;
import flash.utils.ByteArray;
import flash.events.Event;

var sourceFile:File = File.documentsDirectory.resolvePath("Apollo Test/test.txt");
var stream:FileStream = new FileStream();
stream.addEventListener(Event.COMPLETE, readBytes);
stream.openAsync(sourceFile, FileMode.READ);

function readBytes(e:Event):void {
    var bytes:ByteArray = new ByteArray();
    trace("position 0:", stream.position); // 0
    bytes[0] = stream.readByte();
    trace("position 1:", stream.position); // 1
    fileStream.readBytes(bytes, stream.position, 4); 
    trace("position 2:", stream.position); // 5
    stream.close();
}

Die Mindestmenge Daten, die beim asynchronen Lesen von Dateien von der Festplatte gelesen werden.

Diese Eigenschaft legt fest, wie viele Daten ein asynchroner Stream hinter der aktuellen Position zu lesen versucht. Daten werden in Blöcken gelesen, die auf der Seitengröße des Dateisystems basieren. Wenn Sie also readAhead auf einem Computersystem mit einer Seitengröße von 8KB (8192 Byte) auf 9.000 setzen, liest die Laufzeitumgebung jeweils 2 Blöcke, oder 16384 Bytes, voraus. Der Standardwert dieser Eigenschaft ist unendlich; standardmäßig wird eine zum asynchronen Lesen geöffnete Datei bis zum Ende der Datei gelesen.

Das Lesen der Daten aus dem Lesepuffer ändert nicht den Wert der readAhead-Eigenschaft. Wenn Sie Daten aus dem Puffer lesen, werden neue Daten eingelesen, um den Lesepuffer zu füllen.

Die readAhead-Eigenschaft hat keine Auswirkung auf eine synchron geöffnete Datei.

Während Daten asynchron eingelesen werden, löst das FileStream-Objekt progress-Ereignisse aus. Überprüfen Sie in der Ereignisprozedurmethode des progress-Ereignisses, ob die erforderliche Anzahl an Bytes verfügbar ist (indem Sie die bytesAvailable-Eigenschaft überprüfen) und lesen Sie die Daten dann mit einer Lesemethode aus dem Lesepuffer.

import flash.filesystem.*;

var file:File = File.desktopDirectory.resolvePath("test.txt");
var fileStream:FileStream = new FileStream();
fileStream.readAhead = 100;
fileStream.addEventListener(ProgressEvent.PROGRESS, readProgressHandler)
fileStream.openAsync(file, FileMode.READ);
var results:ByteArray;

function readProgressHandler(event:ProgressEvent):void {
    if (fileStream.bytesAvailable >= 100) {
        fileStream.readBytes(results, 0, 100);
    }
}

Erstellt ein FileStream-Objekt. Verwenden Sie die open()- oder openAsync()-Methode, um eine Datei zu öffnen.

Verwandte API-Elemente

Schließt das FileStream-Objekt.

Nach dem Aufrufen der close()-Methode können Sie keine Daten mehr lesen oder schreiben. Wenn die Datei asynchron geöffnet wurde (das FileStream-Objekt hat die Datei mit der openAsync()-Methode geöffnet), löst das Objekt nach dem Aufruf der close()-Methode ein close-Ereignis aus.

Beim Schließen der Anwendung werden automatisch alle Dateien, die mit FileStream-Objekten in der Anwendung verknüpft sind, geschlossen. Am besten registrieren Sie ein closed-Ereignis für alle asynchron geöffneten FileStream-Objekte, in die noch Daten geschrieben werden müssen, bevor die Anwendung geschlossen wird (um sicherzustellen, dass die Daten geschrieben werden).

Sie können das FileStream-Objekt erneut verwenden, indem Sie die open()- oder openAsync()-Methode aufrufen. Damit werden alle Dateien geschlossen, die dem FileStream-Objekt zugewiesen sind, das Objekt löst jedoch nicht das close-Ereignis aus.

Wenn ein FileStream-Objekt asynchron geöffnet wurde (mit der openAsync()-Methode), wird es nicht (durch den Garbagekollektor) aus dem Speichermanagement entfernt, solange noch ausstehende Vorgänge vorliegen und für deren Abschluss Ereignisprozeduren registriert sind. Dies gilt auch dann, wenn Sie das close()-Ereignis für ein FileStream-Objekt aufrufen und Eigenschaften und Variablen löschen, die auf das Objekt verweisen. Ein sonst nicht referenziertes FileStream-Objekt bleibt bestehen, solange eine der folgenden Situationen eintreten kann:

• Bei Lesevorgängen wurde das Ende der Datei nicht erreicht (und das complete-Ereignis wurde nicht ausgelöst).
• Es stehen noch zu schreibende Ausgabedaten zur Verfügung und ausgabebezogene Ereignisse (zum Beispiel das outputProgress-Ereignis oder das ioError-Ereignis) haben Ereignis-Listener registriert.

Verwandte API-Elemente

import flash.filesystem.*;
import flash.events.Event;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.WRITE);
fileStream.writeUTFBytes("Hello");
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();

function fileClosed(event:Event):void {
    trace("closed");
}            

import flash.filesystem.*;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.WRITE);
fileStream.writeUTF("Hello");
fileStream.close();

Öffnet das FileStream-Objekt synchron, wobei auf die im file-Parameter festgelegte Datei verwiesen wird.

Wenn das FileStream-Objekt bereits geöffnet ist, wird die Datei durch den Aufruf dieser Methode vor dem Öffnen geschlossen und es werden keine weiteren Ereignisse (einschließlich close) für die zuvor geöffnete Datei übergegeben.

Auf Systemen, die Dateisperren unterstützen, ist eine Datei, die im Modus „schreiben“ (FileMode.WRITE oder „aktualisieren“ FileMode.UPDATE) geöffnet wurde, erst lesbar, wenn sie geschlossen ist.

Sobald Sie mit den Dateivorgängen fertig sind, rufen Sie die close()-Methode des FileStream-Objekts auf. Manche Betriebssysteme beschränken die Anzahl der gleichzeitig geöffneten Dateien.

Parameter

Verwandte API-Elemente

import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.READ);
var str:String = fileStream.readMultiByte(file.size, File.systemCharset);
trace(str);
fileStream.close();

Öffnet das FileStream-Objekt asynchron, wobei auf die im file-Parameter festgelegte Datei verwiesen wird.

Wenn das FileStream-Objekt bereits geöffnet ist, wird die Datei durch den Aufruf dieser Methode vor dem Öffnen geschlossen und es werden keine weiteren Ereignisse (einschließlich close) für die zuvor geöffnete Datei übergegeben.

Wenn der fileMode-Parameter den Wert FileMode.READ oder FileMode.UPDATE aufweist, liest AIR Daten in den Eingabepuffer, sowie die Datei geöffnet wird, und progress- und open-Ereignisse werden ausgelöst, während die Daten in den Eingabepuffer gelesen werden.

Auf Systemen, die Dateisperren unterstützen, ist eine Datei, die im Modus „schreiben“ (FileMode.WRITE oder „aktualisieren“ FileMode.UPDATE) geöffnet wurde, erst lesbar, wenn sie geschlossen ist.

Sobald Sie mit den Dateivorgängen fertig sind, rufen Sie die close()-Methode des FileStream-Objekts auf. Manche Betriebssysteme beschränken die Anzahl der gleichzeitig geöffneten Dateien.

Parameter

Verwandte API-Elemente

import flash.filesystem.*;
import flash.events.Event;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.addEventListener(Event.COMPLETE, fileCompleteHandler)
fileStream.openAsync(file, FileMode.READ);

function fileCompleteHandler(event:Event):void {
    var str:String = fileStream.readMultiByte(fileStream.bytesAvailable, File.systemCharset);
    trace(str);
    fileStream.close();
}

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

Liest ein vorzeichenbehaftetes Byte vom Dateistream, Bytestream oder Bytearray.

Liest die Anzahl der vom length-Parameter angegebenen Datenbyte aus dem Dateistream, Bytestream oder Bytearray. Die Bytedaten werden ab der im Parameter bytes festgelegten Position in das im Parameter offset angegebenen ByteArray-Objekt gelesen.

Parameter

Liest eine IEEE 754-Gleitkommazahl mit doppelter Genauigkeit vom Dateistream, Bytestream oder Bytearray.

Liest eine IEEE 754-Gleitkommazahl mit einfacher Genauigkeit vom Dateistream, Bytestream oder Bytearray.

Liest eine vorzeichenbehaftete 32-Bit-Ganzzahl vom Dateistream, Bytestream oder Bytearray.

Liest einen Multibyte-String der angegebenen Länge unter Verwendung des angegebenen Zeichensatzes vom Dateistream, Bytestream oder Bytearray.

Parameter

Verwandte API-Elemente

Liest ein Objekt vom Dateistream, Bytestream oder Bytearray, das im serialisierten AMF-Format kodiert ist.

Verwandte API-Elemente

Liest eine vorzeichenbehaftete 16-Bit-Ganzzahl vom Dateistream, Bytestream oder Bytearray.

Liest ein vorzeichenloses Byte vom Dateistream, Bytestream oder Bytearray.

Liest eine vorzeichenlose 32-Bit-Ganzzahl vom Dateistream, Bytestream oder Bytearray.

Liest eine vorzeichenlose 16-Bit-Ganzzahl vom Dateistream, Bytestream oder Bytearray.

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

Diese Methode entspricht der readUTF()-Methode der Java^®-Schnittstelle „IDataInput“.

Liest eine Folge von UTF-8-Byte der Anzahl vom Byte-Datenstrom oder Bytearray und gibt einen String zurück.

Parameter

Schneidet die Datei an der Stelle ab, die durch die position-Eigenschaft des FileStream-Objekts angegeben wird.

Byte von der Stelle, die durch die position-Eigenschaft angegeben wird, bis zum Ende der Datei werden gelöscht. Die Datei muss zum Schreiben geöffnet sein.

Verwandte API-Elemente

import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.UPDATE);
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.close();

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.UPDATE);
trace("start", file.size)
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();
function fileClosed(event:Event):void {
    trace("closed", file.size); 
}

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. Die unteren 8 Bit des Parameters werden verwendet, die oberen 24 Bit werden ignoriert.

Parameter

Schreibt eine Byte-Sequenz vom angegebenen Bytearray in den Dateistream, Bytestream oder das Bytearray, beginnend mit dem durch offset festgelegten Byte (unter Verwendung einer auf null basierenden Indexposition) mit einer durch length festgelegten Länge.

Wird der Parameter length weggelassen, wird die Standardlänge 0 verwendet und der gesamte Puffer wird ab der Position offset geschrieben. 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).

Parameter

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

Parameter

Schreibt eine vorzeichenbehaftete 32-Bit-Ganzzahl.

Parameter

Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes in den Dateistream, Bytestream oder Bytearray.

Parameter

Verwandte API-Elemente

Schreibt ein Objekt im serialisierten AMF-Format in den Dateistream, Bytestream oder Bytearray.

Parameter

Verwandte API-Elemente

Schreibt eine 16-Bit-Ganzzahl. Die unteren 16 Bit des Parameters werden verwendet, die oberen 16 Bit werden ignoriert.

Parameter

Schreibt eine vorzeichenlose 32-Bit-Ganzzahl.

Parameter

Schreibt einen UTF-8-String in den Dateistream, Bytestream oder Bytearray. 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. Entspricht writeUTF(), doch dem String wird kein 16-Bit-Wort mit der Längenangabe vorangestellt.

Parameter

Gibt an, dass der Stream durch einen ausdrücklichen Aufruf der close()-Methode geschlossen wurde.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Gibt an, dass das Ende des Streams erreicht wurde.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Gibt an, dass bei einem asynchronen Datei-E/A-Vorgang ein Fehler aufgetreten ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Gibt an, dass gepufferte Daten in die Datei geschrieben wurden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Gibt an, dass neue Daten im Stream verfügbar sind.

Dieses Ereignis verfügt über die folgenden Eigenschaften: