FileCreate: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
m (indexing translated page) |
||
| (13 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
{{Server function}} | {{Server client function}} | ||
Creates a new file in a directory of a resource. If there already exists a file with the specified name, it is overwritten with an empty file. | Creates a new file in a directory of a resource. If there already exists a file with the specified name, it is overwritten with an empty file. | ||
{{Note|To prevent memory leaks, ensure each successful call to [[fileCreate]] has a matching call to [[fileClose]]}} | |||
{{Note|The file functions should not be used to implement configuration files. It is encouraged to use the XML functions for this instead.}} | |||
{{Tip|If you do not want to share the content of the created file with other servers, prepend the file path with @ (See [[filepath]] for more information)}} | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua">file fileCreate ( string | <syntaxhighlight lang="lua"> | ||
file fileCreate ( string filePath ) | |||
</syntaxhighlight> | |||
{{OOP|This function is a static function underneath the File class.|[[File]].new}} | |||
{{New feature/item|9.0156|1.5.6|11865| | |||
{{OOP|This is a static function underneath the File class. Using '''File(...)''' to open a file will attempt to create the file, if it doesn't exist|[[File]].new}} | |||
}} | |||
=== | ===Required Arguments=== | ||
*''' | *'''filePath:''' The [[filepath]] of the file to be created in the following format: '''":resourceName/path"'''. 'resourceName' is the name of the resource the file is in, and 'path' is the path from the root directory of the resource to the file. | ||
:For example, if you want to create a file named 'myfile.txt' in the resource 'mapcreator', it can be created from another resource this way: ''fileCreate(":mapcreator/myfile.txt")''. | |||
:If the file is in the current resource, only the file path is necessary, e.g. ''fileCreate("myfile.txt")''. | |||
===Returns=== | ===Returns=== | ||
| Line 19: | Line 25: | ||
==Example== | ==Example== | ||
This example creates a text file and writes a string to it. | This example creates a text file in the current resource and writes a string to it. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
local newFile = fileCreate("test.txt") -- attempt to create a new file | local newFile = fileCreate("test.txt") -- attempt to create a new file | ||
if newFile then -- check if the creation succeeded | if (newFile) then -- check if the creation succeeded | ||
fileWrite(newFile, "This is a test file!") -- write a text line | fileWrite(newFile, "This is a test file!") -- write a text line | ||
fileClose(newFile) -- close the file once you're done with it | fileClose(newFile) -- close the file once you're done with it | ||
end | end | ||
</syntaxhighlight> | </syntaxhighlight> | ||
It is important to close a file after you've finished all your operations on it, especially if you've been writing to the file. If you don't close a file and your resource crashes, all changes to the file may be lost. | |||
Notice that you can't simply do ''fileWrite("test.txt", "File content")''. Instead, file functions operate on a '''file handle''', which is a special object representing an open file. ''fileCreate'' creates a file, opens it, and returns the resulting handle. | |||
It is also important to remember to close a file after you've finished all your operations on it, especially if you've been writing to the file. If you don't close a file and your resource crashes, all changes to the file may be lost. | |||
If the file already exists, a new file will be created on local. | |||
==See Also== | |||
{{File functions}} | |||
[[pt-br:fileCreate]] | |||
Latest revision as of 17:15, 20 December 2023
Creates a new file in a directory of a resource. If there already exists a file with the specified name, it is overwritten with an empty file.
| Tip: If you do not want to share the content of the created file with other servers, prepend the file path with @ (See filepath for more information) |
Syntax
file fileCreate ( string filePath )
OOP Syntax Help! I don't understand this!
- Note: This function is a static function underneath the File class.
- Method: File.new(...)
Required Arguments
- filePath: The filepath of the file to be created in the following format: ":resourceName/path". 'resourceName' is the name of the resource the file is in, and 'path' is the path from the root directory of the resource to the file.
- For example, if you want to create a file named 'myfile.txt' in the resource 'mapcreator', it can be created from another resource this way: fileCreate(":mapcreator/myfile.txt").
- If the file is in the current resource, only the file path is necessary, e.g. fileCreate("myfile.txt").
Returns
If successful, returns a file handle which can be used with other file functions (fileWrite, fileClose...). Returns false if an error occured.
Example
This example creates a text file in the current resource and writes a string to it.
local newFile = fileCreate("test.txt") -- attempt to create a new file
if (newFile) then -- check if the creation succeeded
fileWrite(newFile, "This is a test file!") -- write a text line
fileClose(newFile) -- close the file once you're done with it
end
Notice that you can't simply do fileWrite("test.txt", "File content"). Instead, file functions operate on a file handle, which is a special object representing an open file. fileCreate creates a file, opens it, and returns the resulting handle.
It is also important to remember to close a file after you've finished all your operations on it, especially if you've been writing to the file. If you don't close a file and your resource crashes, all changes to the file may be lost. If the file already exists, a new file will be created on local.