Difference between revisions of "love.filesystem.newFile"
(added apparent restriction on ':' in filenames on at least Linux and OS X) |
(close opened file after use) |
||
(One intermediate revision by one other user not shown) | |||
Line 8: | Line 8: | ||
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
− | {{param|string|filename|The filename of the file. | + | {{param|string|filename|The filename of the file.}} |
=== Returns === | === Returns === | ||
{{param|File|file|The new File object.}} | {{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 == | == Function == | ||
Line 32: | Line 34: | ||
file:open("r") | file:open("r") | ||
data = file:read() | data = file:read() | ||
+ | file:close() | ||
+ | -- use the data ... | ||
</source> | </source> | ||
== See Also == | == See Also == |
Latest revision as of 14:29, 15 February 2015
Creates a new File object. It needs to be opened before it can be accessed.
Contents
Function
Synopsis
file = love.filesystem.newFile( filename )
Arguments
string filename
- The filename of the file.
Returns
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 which returns a boolean and an error message if something goes wrong while opening the file.
Function
Available since LÖVE 0.9.0 |
This variant is not supported in earlier versions. |
Creates a File object and opens it for reading, writing, or appending.
Synopsis
file, errorstr = love.filesystem.newFile( filename, mode )
Arguments
Returns
File file
- The new File object, or nil if an error occurred.
string errorstr
- The error string if an error occurred.
Examples
Open a file and read everything
file = love.filesystem.newFile("data.txt")
file:open("r")
data = file:read()
file:close()
-- use the data ...
See Also
Other Languages
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info