PT-BR/HasElementData

From Multi Theft Auto: Wiki
Revision as of 17:19, 7 November 2024 by Fernando187 (talk | contribs) (Remove obsolete Requirements section)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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 )

Veja também