PT-BR/HasElementData

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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