## 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.

View Source doc/classes.js, line 10

# Methods

#### # Close()

Close the file.

View Source doc/classes.js, line 39

#### # GetSize() → {number}

get file size.

View Source doc/classes.js, line 49

Returns:
the size of the file in bytes.
Type: number

#### # ReadByte() → {number}

Read a single byte from file and return it as number.

View Source doc/classes.js, line 15

Returns:
the byte as a number or null for EOF.
Type: number

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

get file contents as number array.

View Source doc/classes.js, line 44

Returns:
the remaining contents of the file as array of numbers.
Type: Array.<number>

#### # ReadLine() → {string}

Read a line of text from file. The maximum line length is 4096 byte.

View Source doc/classes.js, line 25

Returns:
the next line or null for EOF.
Type: string

#### # WriteByte(ch)

Write a single byte to a file.

##### Parameters:

Name | Type | Description
--- | --- | ---
`ch` | number | the byte to write.

View Source doc/classes.js, line 20

#### # 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).

View Source doc/classes.js, line 54

#### # WriteLine(txt)

Write a NEWLINE terminated string to a file.

##### Parameters:

Name | Type | Description
--- | --- | ---
`txt` | string | the string to write.

View Source doc/classes.js, line 30

#### # WriteString(txt)

Write a string to a file.

##### Parameters:

Name | Type | Description
--- | --- | ---
`txt` | string | the string to write.

View Source doc/classes.js, line 35