RemoveElementData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (fix oop syntax)
(add note)
 
(3 intermediate revisions by one other user not shown)
Line 2: Line 2:
__NOTOC__  
__NOTOC__  
This function removes the [[element data]] with the given key for that element. The element data removal is synced with all the clients.
This function removes the [[element data]] with the given key for that element. The element data removal is synced with all the clients.
{{Note|If you want to remove the data in client side you can use 'setElementData(element, key, nil)'.}}


==Syntax==  
==Syntax==  
Line 17: Line 19:


==Example==  
==Example==  
This will create an element data for know if a player has spawned.
This will set element data for player which spawned, and then remove it on death.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function spawn()
function onPlayerSpawn()
     setElementData(source,"spawned",true)
     setElementData(source, "playerSpawned", true)
end
end
addEventHandler ( "onPlayerSpawn", getRootElement(), spawn )
addEventHandler("onPlayerSpawn", root, onPlayerSpawn)
function wasted()
 
     removeElementData(source,"spawned")
function onPlayerWasted()
     removeElementData(source, "playerSpawned")
end
end
addEventHandler ( "onPlayerWasted", getRootElement(), wasted )</syntaxhighlight>
addEventHandler("onPlayerWasted", root, onPlayerWasted)
</syntaxhighlight>


==See Also==
==See Also==
{{Element_functions}}
{{Element_functions}}

Latest revision as of 11:38, 18 October 2023

This function removes the element data with the given key for that element. The element data removal is synced with all the clients.


[[{{{image}}}|link=|]] Note: If you want to remove the data in client side you can use 'setElementData(element, key, nil)'.

Syntax

bool removeElementData ( element theElement, string key ) 

OOP Syntax Help! I don't understand this!

Method: element:removeData(...)


Required Arguments

  • theElement: The element you wish to remove the data from.
  • key: The key string you wish to remove.

Returns

Returns true if the data was removed succesfully, false if the given key does not exist in the element or the element is invalid.

Example

This will set element data for player which spawned, and then remove it on death.

function onPlayerSpawn()
    setElementData(source, "playerSpawned", true)
end
addEventHandler("onPlayerSpawn", root, onPlayerSpawn)

function onPlayerWasted()
    removeElementData(source, "playerSpawned")
end
addEventHandler("onPlayerWasted", root, onPlayerWasted)

See Also

Shared