PT-BR/HasElementData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{BR/Funcao compartilhada}} Esta função verifica se um elemento tem dado de elemento(element data) disponível. ==Sintaxe== <syntaxhighligh...")
 
m (Myonlake moved page HasElementData/PT-BR to PT-BR/HasElementData)
 
(No difference)

Latest revision as of 22:08, 21 February 2021

Esta função verifica se um elemento tem dado de elemento(element data) disponível.

Sintaxe

bool hasElementData ( element oElemento, string chave [, bool herdar = true] )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: elemento:hasData(...)

Argumentos Necessários

  • oElemento: Este é o elemento que você quer verificar se armazena dados.
  • chave: O nome da chave de dado em que o elemento está ou não armazenando. (Máximo 31 caracteres.)

Argumentos Opcionais

  • herdar: Alterna se a função deve ou não ir para o topo da hierarquia para achar a chave requisitada nos casos específicos em que o elemento não tenha isso.

Retorna

Retorna true se o elemento contém dado da chave, ou false se o elemento não existe ou não há dado associado à chave.

Exemplo

Este exemplo mostra o animal favorito ao jogador usando o comando 'bichinho' se ele tiver um definido.

Click to collapse [-]
Server
function MeuAmigaozao ( source, commandName, playerName )
    local oJogador = source
    if playerName then -- veja se o nick de algum jogador foi especificado
        oJogador = getPlayerFromName (playerName) -- obtenha o elemento-jogador através do nick especificado
        if not oJogador then -- Se nós ainda não encontramos um jogador então...
            outputChatBox ( "Não foi possível encontrar: '" .. playerName .. "'", source ) -- mostre a mensagem de erro
            return
        end
    end

    if hasElementData ( oJogador, "animal_favorito" ) then -- verifique se o jogador tem um animal favorito definido
        local favAnimal = getElementData ( oJogador, "animal_favorito" ) -- obtém o animal favorito do jogador  .-.
        outputChatBox ( "O animal favorito de"..getPlayerName ( oJogador ).." : "..favAnimal, source ) -- informe o animal favorito do jogador
    else
        outputChatBox ( getPlayerName ( oJogador ).." não tem um animal favorito", source ) -- informa que o jogador não tem animal favorito
    end
end
-- Adicionamos um comando para executar a função MeuAmigaozao e ver o animal favorito de um jogador especificado
addCommandHandler ( "bichinho", MeuAmigaozao )

Requerimentos

Minimum server version 1.5.7-9.20447
Minimum client version 1.5.7-9.20447

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.5.7-9.20447" client="1.5.7-9.20447" />

Veja também