File

sys.io.File (Class)

API for reading and writing files.

See sys.FileSystem for the complementary file system API.

Static Members

getContent(path: String): String

Retrieves the content of the file specified by path as a String.

If the file does not exist or can not be read, an exception is thrown.

sys.FileSystem.exists can be used to check for existence.

If path is null, the result is unspecified.

Name Type
path String
Returns
String

getBytes(path: String): haxe.io.Bytes

Retrieves the binary content of the file specified by path.

If the file does not exist or can not be read, an exception is thrown.

sys.FileSystem.exists can be used to check for existence.

If path is null, the result is unspecified.

Name Type
path String
Returns
haxe.io.Bytes

saveContent(path: String, content: String): Void

Stores content in the file specified by path.

If the file cannot be written to, an exception is thrown.

If path or content are null, the result is unspecified.

Name Type
path String
content String

saveBytes(path: String, bytes: haxe.io.Bytes): Void

Stores bytes in the file specified by path in binary mode.

If the file cannot be written to, an exception is thrown.

If path or bytes are null, the result is unspecified.

Name Type
path String
bytes haxe.io.Bytes

read(path: String, ?binary: Bool = true): FileInput

Returns an FileInput handle to the file specified by path.

If binary is true, the file is opened in binary mode. Otherwise it is opened in non-binary mode.

If the file does not exist or can not be read, an exception is thrown.

Operations on the returned FileInput handle read on the opened file.

File handles should be closed via FileInput.close once the operation is complete.

If path is null, the result is unspecified.

Name Type Default
path String
binary Bool true
Returns
FileInput

write(path: String, ?binary: Bool = true): FileOutput

Returns an FileOutput handle to the file specified by path.

If binary is true, the file is opened in binary mode. Otherwise it is opened in non-binary mode.

If the file cannot be written to, an exception is thrown.

Operations on the returned FileOutput handle write to the opened file. If the file existed, its previous content is overwritten.

File handles should be closed via FileOutput.close once the operation is complete.

If path is null, the result is unspecified.

Name Type Default
path String
binary Bool true
Returns
FileOutput

append(path: String, ?binary: Bool = true): FileOutput

Similar to sys.io.File.write, but appends to the file if it exists instead of overwriting its contents.

Name Type Default
path String
binary Bool true
Returns
FileOutput

copy(srcPath: String, dstPath: String): Void

Copies the contents of the file specified by srcPath to the file specified by dstPath.

If the srcPath does not exist or cannot be read, or if the dstPath file cannot be written to, an exception is thrown.

If the file at dstPath exists, its contents are overwritten.

If srcPath or dstPath are null, the result is unspecified.

Name Type
srcPath String
dstPath String