FileCopy: Difference between revisions

Revision as of 17:35, 20 December 2023

This function copies a file.

[[{{{image}}}\|link=\|]]	Note: The file functions should not be used to implement configuration files. It is encouraged to use the XML functions for this instead.

[[{{{image}}}\|link=\|]]	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

bool fileCopy ( string filePath, string copyToFilePath [, bool overwrite = false ] )

OOP Syntax Help! I don't understand this!

Note: This function is a static function underneath the File class.

Method: File.copy(...)

Required Arguments

filePath: The path of the file you want to copy.
copyToFilePath: Where to copy the specified file to.

Optional Arguments

overwrite: If set to true it will overwrite a file that already exists at copyToFilePath.

Returns

Return true if the file was copied, else false if the 'filePath' doesn't exist.

Example

Click to collapse [-]

Server

This example copies a file called 'test.txt' and called it 'test1.txt'.

addEventHandler("onResourceStart", resourceRoot, function(res)
    local filePath = ":"..getResourceName(res).."/test.txt"
    fileCreate(filePath) --create the file in this resource and name it 'test.txt'.
    if fileCopy(filePath, ":"..getResourceName(res).."/test1.txt") then
         outputChatBox("File was successfully copied!", root, 0, 100, 0)
    else
         outputChatBox("File was not successfully copied, probably because it doesn't exist.", root, 100, 0, 0)
    end
end)

Click to collapse [-]

Client

This example copies a file called 'test.txt' and called it 'test1.txt'.

addEventHandler("onClientResourceStart", resourceRoot, function(res)
    local filePath = ":"..getResourceName(res).."/test.txt"
    fileCreate(filePath) --create the file in this resource and name it 'test.txt'.
    if fileCopy(filePath,":"..getResourceName(res).."/test1.txt") then
         outputChatBox("File was successfully copied!", 0, 100, 0)
    else
        outputChatBox("File was not successfully copied, probably because it doesn't exist.", 100, 0, 0)
    end
end)

This template will be deleted.

@@ Line 55: / Line 55: @@
 ==See Also==
 {{File functions}}
+[[pt-br:fileCopy]]