setElementData

Guarda um valor no elemento.

Sintaxe

-- servidor
bool setElementData ( element oElemento, string chave, any valor
                      [, mixed sincronizacao = true, string confiancaDoCliente ] )

-- cliente
bool setElementData ( element oElemento, string chave, any valor [, bool sincronizar = true ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oElemento	element	—	Elemento que guarda o dado.
chave	string	—	Nome da chave.
valor	any	—	Valor a guardar. nil guarda nil: a chave continua existindo e getElementData devolve nil para ela. No cliente este argumento é obrigatório; omiti-lo registra um aviso e devolve false.
sincronizacao	bool ou string	true	Só no servidor. Quem recebe o valor. Veja a tabela abaixo.
confiancaDoCliente	string	inalterada	Só no servidor. Se os clientes podem escrever nesta chave. Veja abaixo.
sincronizar	bool	true	Só no cliente. false mantém a escrita nesta máquina.

Modos de sincronização aceitos (servidor):

Valor	Efeito
true ou qualquer outro valor	Envia para todos os clientes.
false ou "local"	Fica só no servidor.
"subscribe"	Envia apenas para os jogadores inscritos com addElementDataSubscriber.

Retorno

true em caso de sucesso. false quando nada mudou — o que inclui escrever o valor que a chave já tem.

Para apagar uma chave no servidor, use removeElementData.