Write data to a file in the save directory. If the file existed already, it will be completely replaced by the new contents.
== Function ==
=== Synopsis ===
<source lang="lua">
success, message = love.filesystem.write( name, data, size )
</source>
=== Arguments ===
{{param|string|name|The name (and path) of the file.}}
{{param|string|data|The string data to write to the file.}}
{{param|number|size (all)|How many bytes to write.}}
=== Returns ===
{{param|boolean|success|If the operation was successful.}}
{{param|string|message|Error message if operation was unsuccessful.}}

== Function ==
=== Synopsis ===
<source lang="lua">
success, message = love.filesystem.write( name, data, size )
</source>
=== Arguments ===
{{param|string|name|The name (and path) of the file.}}
{{param|Data|data|The Data object to write to the file.}}
{{param|number|size (all)|How many bytes to write.}}
=== Returns ===
{{param|boolean|success|If the operation was successful.}}
{{param|string|message|Error message if operation was unsuccessful.}}

== Notes ==
If you are getting the error message "Could not set write directory", try setting the save directory. This is done either with [[love.filesystem.setIdentity]] or by setting the identity field in [[love.conf]].

'''Writing to multiple lines''': In Windows, some text editors (e.g. Notepad) only treat CRLF ("\r\n") as a new line.

== See Also ==
* [[parent::love.filesystem]]
* [[love.filesystem.append]]
[[Category:Functions]]
{{#set:Description=Write data to a file.}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|love.filesystem.write}}