File-objekt
File-objekt har ett par funktioner som du kan använda för att läsa och skriva till textfiler.
Exempel som läser innehållet från filen ”TestIn.txt”, och skriver innehållet till filen ”TestOut.txt”:
var fileIn = new File("TestIn.txt", OPEN_ALWAYS);
var fileOut = new File("TestOut.txt", CREATE_ALWAYS);
fileOut.write(fileIn.read());
Egenskaper i File-objekt
File-objekt har inga särskilda egenskaper.
File-konstruktorn
new File(fileName, creationDisposition = OPEN_ALWAYS)
Skapar ett nytt File-objekt med angivet filnamn och någon av följande flaggor.
CREATE_NEW skapar en ny fil, misslyckas om filen redan finns.
CREATE_ALWAYS skapar en ny fil, finns den redan skrivs den över.
OPEN_EXISTING öppnar befintlig fil, misslyckas om den inte finns.
OPEN_ALWAYS öppnar filen, finns den inte skapas en ny.
TRUNCATE_EXISTING öppnar filen och trunkerar den så storleken blir 0 bytes, misslyckas om filen inte finns.
File-prototypen
File.prototype.atEnd()
Talar om huruvuda filpekaren står i slutet av filen (EOF).
File.prototype.close()
Stänger en öppen fil.
File.prototype.getSize()
Returnerar storleken på filen i bytes.
File.prototype.isOpen()
Talar om huruvida filen är öppen.
File.prototype.lastModification()
Returnerar datum och tid för senaste modifikation av filen i ett datumobjekt.
File.prototype.position()
Returnerar aktuell position av filpekaren relativt början på filen.
File.prototype.read([maxSizeToRead])
Läser all data från filen eller upp till maxSizeToRead bytes.
File.prototype.readLine()
Läser data från filen tills EOL påträffas eller 8192 bytes har lästs och returnerar strängen inklusive EOL tecknen. EOL är CR och/eller NL.
File.prototype.seek(relativePos[, reference = FILE_BEGIN])
Sätter filpekaren till positionen relativePos relativt referensen. reference kan vara FILE_BEGIN, FILE_CURRENT eller FILE_END. Anger du inte reference används FILE_BEGIN som referens. Metoden returnerar också aktuell filposition relativt filens början.
File.prototype.setFilePointer(reference[, relativePos = 0])
Sätter filpekaren till positionen relativePos relativt referense. reference kan vara FILE_BEGIN, FILE_CURRENT eller FILE_END. Anger du inte relativePos används 0 som relativePos, vilket innebär att filpekaren sätts filens början, står kvar där den står respektive sätts till slutet på filen. Metoden returnerar också aktuell filposition relativt filens början.
File.prototype.write(data)
Skriver data till aktuell position i filen.