FileCreate: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 9: Line 9:
<syntaxhighlight lang="lua">file fileCreate ( string filename, resource root = getThisResource () )</syntaxhighlight>
<syntaxhighlight lang="lua">file fileCreate ( string filename, resource root = getThisResource () )</syntaxhighlight>


===Required arguments===
===Required Arguments===
*'''filename:''' the name of the file you wish to create.
*'''filename:''' the name of the file you wish to create.


===Optional arguments===
===Optional Arguments===
*'''root:''' the resource in which the file should be created. Defaults to the resource calling the function.
*'''root:''' the resource in which the file should be created. Defaults to the resource calling the function.


Line 31: Line 31:


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.
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.
==See Also==
{{File functions}}

Revision as of 10:34, 24 November 2007

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: The file functions should not be used to implement configuration files. It is encouraged to use the XML functions for this instead.

Syntax

file fileCreate ( string filename, resource root = getThisResource () )

Required Arguments

  • filename: the name of the file you wish to create.

Optional Arguments

  • root: the resource in which the file should be created. Defaults to the resource calling the function.

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 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.

See Also