Creates a new [[File]] object. 
It needs to be opened before it can be accessed.

== Function ==
=== Synopsis ===
<source lang="lua">
file = love.filesystem.newFile( filename )
</source>
=== Arguments ===
{{param|string|filename|The filename of the file.}}
=== Returns ===
{{param|File|file|The new File object.}}
=== Notes ===
Please note that this function will not return any error message (e.g. if you use an invalid filename) because it just creates the File Object. You can still check if the file is valid by using [[(File):open|File:open]] which returns a boolean and an error message if something goes wrong while opening the file.

== Function ==
{{newin|[[0.9.0]]|090|type=variant}}
Creates a [[File]] object and opens it for reading, writing, or appending.
=== Synopsis ===
<source lang="lua">
file, errorstr = love.filesystem.newFile( filename, mode )
</source>
=== Arguments ===
{{param|string|filename|The filename of the file.}}
{{param|FileMode|mode|The mode to open the file in.}}
=== Returns ===
{{param|File|file|The new File object, or nil if an error occurred.}}
{{param|string|errorstr|The error string if an error occurred.}}

== Examples ==
=== Open a file and read everything ===
<source lang="lua">
file = love.filesystem.newFile("data.txt")
file:open("r")
data = file:read()
file:close()
-- use the data ...
</source>
== See Also ==
* [[parent::love.filesystem]]
* [[Constructs::File]]
[[Category:Functions]]
{{#set:Description=Creates a new [[File]] object.}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|love.filesystem.newFile}}