FILE

Class that represents file on file system. On the server, available only if NXSL.EnableFileIOFunctions server configuration variable is turned on (change requires server restart). Use IO::OpenFile() function to create a new FILE object.

File read and write position in the file depends on mode file was opened in.

Instance attributes

eof: int: Non-zero value if end of file was reached, 0 otherwise. The value is undefined after the file is closed (known issue, netxms#3808).

name: String: File name

Instance methods

close(): void: Close file

read(numberOfSymbols): String

Read provided number of bytes from file.

Table 1. Parameters
numberOfSymbols	Integer	Number of symbol to read from file

Return

String with symbols read from file (empty string if numberOfSymbols is zero or negative), or null if file closed or end of file reached.

readLine(): String: Read line from file.

Return

String with read line from file (without the trailing newline character), or null if file closed or end of file reached. Lines longer than 8191 characters are returned in parts.

write(text): void

Will write provided text to the file.

Table 2. Parameters
text	String	Text to write in to the file

writeLine(text): void

Will write provided text to the file and will add new line at the end.

Table 3. Parameters
text	String	Text to write in to the file