PT-BR/takeNumFromElementData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{BR/Funcao compartilhada - Shared}} Esta função é utilizada para subtrair o numero de uma determinada ElementData. '''NOTA:''' Só pode ser usa...")
 
mNo edit summary
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{BR/Funcao compartilhada - Shared}}
{{PT-BR/Useful_function}}
Esta função é utilizada para subtrair o numero de uma determinada [[Element_data|ElementData]].  
Esta função é utilizada para subtrair o numero de uma determinada [[PT-BR/Element_data|ElementData]].  
'''NOTA:''' Só pode ser usado em [[Element_data|ElementData]].
'''NOTA:''' Só pode ser usado em [[PT-BR/Element_data|ElementData]].


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool takeNumFromElementData( player thePlayer, int amount, string elementName )
bool takeNumFromElementData( player thePlayer, int amount, string key )
</syntaxhighlight>
</syntaxhighlight>


Line 12: Line 12:
*'''thePlayer''': Caso seja em server-side, caso seja em client-side use: getLocalPlayer().
*'''thePlayer''': Caso seja em server-side, caso seja em client-side use: getLocalPlayer().
*'''amount''': O valor que deseja subtrair.
*'''amount''': O valor que deseja subtrair.
*'''elementName''': O nome do [[Element_data|ElementData]] a qual você deseja subtrair o valor.
*'''key''': O nome do [[PT-BR/Element_data|ElementData]] a qual você deseja subtrair o valor.
 


===Returns===
===Returns===
Line 21: Line 20:
<section name="Funcao compartilhada - Shared" class="shared" show="true">
<section name="Funcao compartilhada - Shared" class="shared" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function takeNumFromElementData( thePlayer, amount, elementName)
function takeNumFromElementData( thePlayer, amount, key)
if tonumber ( amount )  then
    if tonumber ( amount )  then
if ( getElementData( thePlayer, tostring ( elementName ) ) ) then
        if ( getElementData( thePlayer, tostring ( key ) ) ) then
setElementData ( thePlayer, elementName, ( getElementData( thePlayer, tostring ( elementName ) ) -1 ) )
            return setElementData ( thePlayer, key, ( getElementData( thePlayer, tonumber( key ) ) - tonumber(amount) ) )
else
        else
outputDebugString ( "Error: arg.3", 3, 255, 0, 0, 0 )
            outputDebugString ( "Error: arg.3", 3, 255, 0, 0, 0 )
end
        end
else
    else
outputDebugString ( "Error: arg.2", 3, 255, 0, 0, 0 )
        outputDebugString ( "Error: arg.2", 3, 255, 0, 0, 0 )
  end
    end
  return false
end
end
</syntaxhighlight>
</syntaxhighlight>
Line 39: Line 39:
==Exemplo==
==Exemplo==
<section name="Server" class="server" show="true">
<section name="Server" class="server" show="true">
Este exemplo subtrair o número de um [[Element_data|ElementData]], chamado: "HR_BANK".
Este exemplo subtrair o número de um [[PT-BR/Element_data|ElementData]], chamado: "HR_LEVEL".
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function RemoverLevels( thePlayer, command, amount, elementName )
function RemoverLevels( thePlayer, command, amount, key )
   takeNumFromElementData(thePlayer, amount, elementName)
   takeNumFromElementData(thePlayer, amount, key )
end
end
addEventHandler ( "takelevels", RemoverLevels)
addEventHandler ( "takelevels", RemoverLevels) -- no caso o comando seria: /takelevels 20 HR_LEVEL
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>


==Veja Também==
==Veja Também==
[[addNumFromElementData|takeNumFromElementData]]
{{Element_functions}}
{{Element_functions}}

Latest revision as of 20:47, 1 April 2023

Esta função é utilizada para subtrair o numero de uma determinada ElementData. NOTA: Só pode ser usado em ElementData.

Syntax

bool takeNumFromElementData( player thePlayer, int amount, string key )

Argumentos obrigatórios

  • thePlayer: Caso seja em server-side, caso seja em client-side use: getLocalPlayer().
  • amount: O valor que deseja subtrair.
  • key: O nome do ElementData a qual você deseja subtrair o valor.

Returns

Se esta função retorna arg.3 quer dizer que o elemento citado não exista ou não tem valor atribuido, arg.2 caso não determine o valor(lembrando deve ser um número !).

Código

Click to collapse [-]
Funcao compartilhada - Shared
function takeNumFromElementData( thePlayer, amount, key)
    if tonumber ( amount )  then
        if ( getElementData( thePlayer, tostring ( key ) ) ) then
            return setElementData ( thePlayer, key, ( getElementData( thePlayer, tonumber( key ) ) - tonumber(amount) ) )
        else
            outputDebugString ( "Error: arg.3", 3, 255, 0, 0, 0 )
        end
    else
        outputDebugString ( "Error: arg.2", 3, 255, 0, 0, 0 )
    end
  	return false
end

Author: Hiroshi Nagaza


Exemplo

Click to collapse [-]
Server

Este exemplo subtrair o número de um ElementData, chamado: "HR_LEVEL".

function RemoverLevels( thePlayer, command, amount, key )
   takeNumFromElementData(thePlayer, amount, key )
end
addEventHandler ( "takelevels", RemoverLevels) -- no caso o comando seria: /takelevels 20 HR_LEVEL

Veja Também