PT-BR/HasElementData: Difference between revisions

Latest revision as of 17:19, 7 November 2024

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 )

@@ Line 42: / Line 42: @@
 </syntaxhighlight>
 </section>
-==Requerimentos==
-{{Requirements|1.5.7-9.20447|1.5.7-9.20447|}}
 ==Veja também==
 {{Element functions}}