Class

File

File(filename, mode)

Constructor

# new File(filename, mode)

Open a file, for file modes see FILE. Files can only either be read or written, never both. Writing to a closed file throws an exception.
Parameters:
Name Type Description
filename string the name of the file.
mode FILE READ, WRITE or APPEND.

Methods

# Close()

Close the file.

# GetSize() → {number}

get file size.
the size of the file in bytes.
number

# ReadByte() → {number}

Read a single byte from file and return it as number.
the byte as a number or null for EOF.
number

# ReadBytes() → {Array.<number>}

get file contents as number array.
the remaining contents of the file as array of numbers.
Array.<number>

# ReadLine() → {string}

Read a line of text from file. The maximum line length is 4096 byte.
the next line or null for EOF.
string

# WriteByte(ch)

Write a single byte to a file.
Parameters:
Name Type Description
ch number the byte to write.

# WriteBytes(data)

Write a bytes to a file.
Parameters:
Name Type Description
data Array.<number> the data to write as array of numbers (must be integers between 0-255).

# WriteBytes(zip_name, data)

Write a bytes to a file in the ZIP.
Parameters:
Name Type Description
zip_name string the full path of the file in the ZIP.
data Array.<number> the data to write as array of numbers (must be integers between 0-255).

# WriteLine(txt)

Write a NEWLINE terminated string to a file.
Parameters:
Name Type Description
txt string the string to write.

# WriteString(txt)

Write a string to a file.
Parameters:
Name Type Description
txt string the string to write.