FileStream  - AS3

Hiermee wordt het aantal beschikbare gegevensbytes voor het lezen in de invoerbuffer geretourneerd. Gebruikerscode moet bytesAvailable aanroepen om er zeker van te zijn dat voldoende gegevens beschikbaar zijn voordat wordt geprobeerd deze te lezen met een van de methoden read.

De bytevolgorde voor de gegevens, de constante BIG_ENDIAN of LITTLE_ENDIAN uit de klasse Endian.

Bepaalt of de indeling AMF3 of AMF0 wordt gebruikt bij het lezen of schrijven van binaire gegevens met de methode readObject() of writeObject().

De waarde is een constante van de klasse ObjectEncoding. Standaard wordt de indeling AMF3 gebruikt.

Verwante API-elementen

De huidige positie in het bestand.

De waarde wordt op een van de volgende manieren gewijzigd:

• wanneer u de eigenschap expliciet instelt
• Wanneer wordt gelezen van het FileStream-object (met een van de leesmethoden)
• wanneer wordt geschreven naar het FileStream-object

De positie is gedefinieerd als een getal (in plaats van een eenheid) om bestanden te ondersteunen die langer zijn dan 2³² bytes. De waarde van deze eigenschap is altijd een geheel getal kleiner dan 2⁵³. Als u deze waarde op een getal met een breuk instelt, wordt de waarde naar beneden afgerond naar het dichtstbijzijnde gehele getal.

Als u bij het asynchroon lezen van een bestand de eigenschap position instelt, begint de toepassing de leesbuffer te vullen met gegevens, vanaf de opgegeven positie, en kan de eigenschap bytesAvailable op 0 worden gezet. Wacht op een gebeurtenis complete voordat u een leesmethode gebruikt om gegevens te lezen; of wacht op een gebeurtenis progress en controleer de eigenschap bytesAvailable voordat u een leesmethode gebruikt.

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();
}

De minimale hoeveelheid gegevens die van de schijf kan worden gelezen bij het asynchroon lezen van bestanden.

Deze eigenschap bepaalt hoeveel gegevens een asynchrone stroom probeert te lezen na de huidige positie. De gegevens worden in blokken gelezen, op basis van het paginaformaat van het bestandssysteem. Als u readAhead bijvoorbeeld instelt op 9000 op een computersysteem met een paginaformaat van 8 kB (8192 byte), leest de runtime 2 blokken vooruit (of 16.384 bytes tegelijkertijd). De standaardwaarde van deze eigenschap is oneindig: standaard wordt een bestand dat is geopend om asynchroon te worden gelezen, gelezen tot aan het einde van het bestand.

Gegevens in de leesbuffer lezen verandert de waarde van de eigenschap readAhead niet. Wanneer u gegevens uit de buffer leest, worden nieuwe gegevens gelezen om de leesbuffer opnieuw te vullen.

De eigenschap readAhead heeft geen invloed op een bestand dat synchroon is geopend.

Bij het asynchroon lezen van gegevens verzendt het FileStream-object progress-gebeurtenissen. In de gebeurtenishandlermethode voor de gebeurtenis progress controleert u of het vereiste aantal bytes beschikbaar is (door de eigenschap bytesAvailable te controleren) en leest u daarna de gegevens uit de leesbuffer met een leesmethode.

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);
    }
}

Maakt een object van het type FileStream. Gebruik de methode open() of openAsync() om een bestand te openen.

Verwante API-elementen

Sluit het FileStream-object.

Nadat u de methode close() hebt aangeroepen, kunt u geen gegevens meer lezen of schrijven. Als het bestand asynchroon is geopend (het FileStream-object heeft de methode openAsync() gebruikt om het bestand te openen), verzendt het object met het aanroepen van de methode close() de gebeurtenis close.

Als de toepassing automatisch wordt gesloten, worden alle bestanden gesloten die in de toepassing aan FileStream-objecten zijn gekoppeld. Het is echter het beste om te registreren voor de gebeurtenis closed op alle FileStream-objecten die asynchroon zijn geopend waarvoor nog gegevens klaar staan om te worden geschreven, voordat u de toepassing sluit (om er zeker van te zijn dat de gegevens worden geschreven).

U kunt het FileStream-object nogmaals gebruiken door de methode open() of openAsync() aan te roepen. Hierdoor worden alle bestanden gesloten die aan het FileStream-object zijn gekoppeld, maar het object verzendt de gebeurtenis close niet.

Voor een FileStream-object dat asynchroon is geopend (met de methode openAsync()) geldt dat, zelfs als u de gebeurtenis close() aanroept voor een FileStream-object en eigenschappen en variabelen verwijdert die naar het object verwijzen, het FileStream-object niet wordt opgeschoond zolang er bewerkingen in behandeling zijn en er gebeurtenishandlers zijn geregistreerd voor de voltooiing. Een FileStream-object waarnaar verder niet wordt verwezen, zal dan aanwezig blijven zolang een van de volgende mogelijkheden nog bestaan:

• Bij het lezen van bestanden is het einde van het bestand nog niet bereikt (en de gebeurtenis complete is niet verzonden).
• Er zijn nog uitvoergegevens beschikbaar die moeten worden geschreven en aan uitvoer gerelateerde gebeurtenissen (zoals de gebeurtenis outputProgress of ioError) hebben gebeurtenislisteners geregistreerd.

Verwante API-elementen

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();

Opent het FileStream-object synchroon, waarbij het bestand wordt aangewezen dat met de parameter file is opgegeven.

Als het FileStream-object al geopend is, wordt het bestand eerst gesloten voordat het wordt geopend en worden geen andere gebeurtenissen (inclusief close) verzonden voor het eerder geopende bestand.

Op systemen waarop bestandsblokkering wordt ondersteund, is een bestand dat in de modus "schrijven" of "bijwerken" is geopend (FileMode.WRITE of FileMode.UPDATE), pas leesbaar wanneer het gesloten is.

Wanneer u klaar bent met het uitvoeren van bewerkingen op het bestand, roept u de close()-methode van het FileStream-object op. Sommige besturingssystemen beperken het aantal bestanden die tegelijkertijd geopend kunnen worden.

Parameters

Verwante API-elementen

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();

Opent het FileStream-object asynchroon, waarbij het bestand wordt aangewezen dat met de parameter file is opgegeven.

Als het FileStream-object al geopend is, wordt het bestand eerst gesloten voordat het wordt geopend en worden geen andere gebeurtenissen (inclusief close) verzonden voor het eerder geopende bestand.

Als de fileMode-parameter is ingesteld op FileMode.READ of FileMode.UPDATE, leest AIR gegevens in de invoerbuffer zodra het bestand wordt geopend en worden de gebeurtenissen progress en open verzonden terwijl de gegevens in de invoerbuffer worden gelezen.

Op systemen waarop bestandsblokkering wordt ondersteund, is een bestand dat in de modus "schrijven" of "bijwerken" is geopend (FileMode.WRITE of FileMode.UPDATE), pas leesbaar wanneer het gesloten is.

Wanneer u klaar bent met het uitvoeren van bewerkingen op het bestand, roept u de close()-methode van het FileStream-object op. Sommige besturingssystemen beperken het aantal bestanden die tegelijkertijd geopend kunnen worden.

Parameters

Verwante API-elementen

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();
}

Leest een booleaanse waarde uit de bestandsstream, bytestream of bytearray. Er wordt één byte gelezen en true wordt geretourneerd wanneer de byte niet gelijk is aan 0. Anders wordt false geretourneerd.

Leest een byte met teken uit de bestandsstream, bytestream of bytearray.

Leest het aantal gegevensbytes dat met de parameter length is opgegeven, uit de bestandsstream, bytestream of bytearray. De bytes worden ingelezen in het object ByteArray, dat is opgegeven door de parameter bytes, te beginnen bij de positie die is opgegeven door offset.

Parameters

Leest een IEEE 754 drijvende-kommagetal met dubbele precisie uit de bestandsstream, bytestream of bytearray.

Leest een IEEE 754 drijvende-kommagetal met enkele precisie uit de bestandsstream, bytestream of bytearray.

Leest een 32-bits geheel getal met teken uit de bestandsstream, bytestream of bytearray.

Leest een multibyte-tekenreeks van de opgegeven lengte met de opgegeven tekenset uit de bestandsstream, bytestream of bytearray.

Parameters

Verwante API-elementen

Leest een object dat in AMF-indeling met serienummering is gecodeerd, uit de bestandsstream, bytestream of bytearray.

Verwante API-elementen

Leest een 16-bits geheel getal met teken uit de bestandsstream, bytestream of bytearray.

Leest een byte zonder teken uit de bestandsstream, bytestream of bytearray.

Leest een 32-bits geheel zonder teken uit de bestandsstream, bytestream of bytearray.

Leest een 16-bits geheel zonder teken uit de bestandsstream, bytestream of bytearray.

Leest een UTF-8-tekenreeks uit de bestandsstream, bytestream of bytearray. Er wordt aangenomen dat de tekenreeks begint met een kort geheel getal zonder teken dat de lengte in bytes aangeeft.

Deze methode is vergelijkbaar met de methode readUTF() in de Java^®-interface IDataInput.

Leest een reeks van UTF-8-bytes uit de bytestream of bytearray en retourneert een tekenreeks.

Parameters

Kort het bestand in op de positie die is aangegeven door de eigenschap position van het FileStream-object.

Bytes worden verwijderd vanaf de positie die is aangegeven door de eigenschap position tot het einde van het bestand. Het bestand moet geopend zijn voor schrijven.

Verwante API-elementen

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); 
}

Schrijft een booleaanse waarde. Er wordt volgens de parameter value één byte geschreven, 1 indien true of 0 indien false.

Parameters

Schrijft een byte. De lage 8 bits van de parameter worden gebruikt, de hoge 24 bits worden genegeerd.

Parameters

Schrijft een reeks van bytes vanuit de opgegeven bytearray bytes, te beginnen op de byte die is opgegeven met offset (met een op nul gebaseerde indexwaarde) met een lengte die is opgegeven met length, naar de bestandsstream, bytestream of bytearray.

Wanneer de parameter length wordt weggelaten, wordt de standaardlengte 0 gebruikt en wordt de gehele buffer geschreven, beginnend bij offset. Wanneer de parameter offset ook wordt weggelaten, wordt de gehele buffer geschreven.

Wanneer de parameter offset of length zich buiten het bereik bevindt, worden ze vastgeklemd aan het begin en het einde van de array bytes.

Parameters

Schrijft een IEEE 754 drijvende-kommagetal (64-bits) met dubbele precisie.

Parameters

Schrijft een IEEE 754 drijvende-kommagetal (32-bits) met enkele precisie.

Parameters

Schrijft een 32-bits geheel getal met teken.

Parameters

Schrijft een multibyte-tekenreeks naar de bestandsstream, bytestream of byte-array met de opgegeven tekenset.

Parameters

Verwante API-elementen

Schrijft een object dat in AMF-indeling met serienummering is gecodeerd, naar de bestandsstream, bytestream of bytearray.

Parameters

Verwante API-elementen

Schrijft een 16-bits geheel getal. De lage 16 bits van de parameter worden gebruikt, de hoge 16 bits worden genegeerd.

Parameters

Schrijft een 32-bits geheel getal zonder teken.

Parameters

Schrijft een UTF-8-tekenreeks naar de bestandsstream, bytestream of byte-array. De lengte van de UTF-8-tekenreeks in bytes wordt eerst als een 16-bits geheel getal geschreven en wordt gevolgd door de bytes die de tekens van de tekenreeks vertegenwoordigen.

Parameters

Schrijft een UTF-8-tekenreeks. Vergelijkbaar met writeUTF(), maar voegt geen 16-bits woord als voorvoegsel toe aan de tekenreeks.

Parameters

Geeft aan dat de stroom is gesloten door een expliciete aanroep van de methode close().

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Geeft aan dat het einde van de stroom is bereikt.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Geeft aan dat er een fout is opgetreden tijdens een asynchrone I/O-bewerking van het bestand.

Deze gebeurtenis heeft de volgende eigenschappen:

Geeft aan dat de gebufferde gegevens naar het bestand zijn geschreven.

Deze gebeurtenis heeft de volgende eigenschappen:

Geeft aan dat er nieuwe gegevens beschikbaar zijn in de stroom.

Deze gebeurtenis heeft de volgende eigenschappen: