Multi Theft Auto: Wiki - User contributions [en]

FileWrite

2021-03-04T09:51:43Z

Oldmr3b: /* Syntax */

__NOTOC__
{{Server client function}}
Writes one or more strings to a given file, starting at the current read/write position. Advances the position over the number of bytes that were written.

==Syntax==
<syntaxhighlight lang="lua">
int fileWrite ( file theFile, string string1 [, string string2, string string3 ...])
</syntaxhighlight>
{{OOP||[[file]]:write}}

===Required Arguments===
*'''theFile:''' A handle to the file you wish to write to. The file must have been opened with write access, i.e. the file handle must be a result of [[fileCreate]] or [[fileOpen]] with the readonly parameter set to ''false''.
*'''string1:''' The string to write.

===Optional Arguments===
*You can provide any number of additional strings to write after '''string1'''. These will be written in the order in which they are specified.

===Returns===
Returns the number of bytes successfully written to the file, returns ''false'' if invalid arguments were specified.

==Example==
This example creates a text file and writes a string to it.
<syntaxhighlight lang="lua">
local fileHandle = fileCreate("test.txt") -- attempt to create a new file
if fileHandle then -- check if the creation succeeded
fileWrite(fileHandle, "This is a test file!") -- write a text line
fileClose(fileHandle) -- close the file once you're done with it
end
</syntaxhighlight>
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.

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

FileWrite

2021-03-04T09:51:33Z

Oldmr3b: /* Syntax */

__NOTOC__
{{Server client function}}
Writes one or more strings to a given file, starting at the current read/write position. Advances the position over the number of bytes that were written.

==Syntax==
<syntaxhighlight lang="lua">
int fileWrite ( file theFile, string string1 [, string string2, string string3 ...])
</syntaxhighlight>
{{OOP||[[file]]:write}}ي

===Required Arguments===
*'''theFile:''' A handle to the file you wish to write to. The file must have been opened with write access, i.e. the file handle must be a result of [[fileCreate]] or [[fileOpen]] with the readonly parameter set to ''false''.
*'''string1:''' The string to write.

===Optional Arguments===
*You can provide any number of additional strings to write after '''string1'''. These will be written in the order in which they are specified.

===Returns===
Returns the number of bytes successfully written to the file, returns ''false'' if invalid arguments were specified.

==Example==
This example creates a text file and writes a string to it.
<syntaxhighlight lang="lua">
local fileHandle = fileCreate("test.txt") -- attempt to create a new file
if fileHandle then -- check if the creation succeeded
fileWrite(fileHandle, "This is a test file!") -- write a text line
fileClose(fileHandle) -- close the file once you're done with it
end
</syntaxhighlight>
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.

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

Multi Theft Auto: Wiki:Exports.global:giveMoney

2021-02-28T04:44:20Z

Oldmr3b: Oldmr3b moved page Oldmr3b to Multi Theft Auto: Wiki:Exports.global:giveMoney

== exports.global:giveMoney ==
The function gives the player money in RolePlay
==Syntax==
<syntaxhighlight lang="lua">
bool exports.global:giveMoney ( theElement, amount )
</syntaxhighlight>
{{OOP||player:giveMoney|.money}}

===Required Arguments===
*'''thePlayer:''' the player you are giving the money to..
*'''amount:''' a positive integer number specifying the amount of money to give to the player.

===Returns===
Returns true if the money was added, or false if invalid parameters were passed.
==Example==
<section show="true" name="Example 1 - Server" class="server">
This example gives a player money when using "givemoney" command.
<syntaxhighlight lang="lua">
function givePlayerMoney ( thePlayer, command, amount ) --when the givecash command is called
exports.global:giveMoney ( thePlayer, amount ) --give the player money according to the amount
end
addCommandHandler ( "givemoney", givePlayerMoney) --add a handler function for the command "givecash"
</syntaxhighlight>
</section>
<section show="true" name="Example 2 - Client" class="client">
This example gives a player money when using "givemoney" command.
<syntaxhighlight lang="lua">
function givePlayerMoney ( command, amount ) --when the givecash command is called
exports.global:giveMoney ( localPlayer, amount ) --give the player money according to the amount
end
addCommandHandler ( "givemoney", givePlayerMoney) --add a handler function for the command "givecash"
</syntaxhighlight>
</section>

Multi Theft Auto: Wiki:Exports.global:giveMoney

2021-02-28T04:42:51Z

Oldmr3b:

Multi Theft Auto: Wiki:Exports.global:giveMoney

2021-02-28T04:31:25Z

Oldmr3b: Created page with "role play"

role play