RemoveElementData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Reverted edits by Ccw (talk) to last revision by Gothemsh)
(add note)
 
(7 intermediate revisions by 4 users 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 7: Line 9:
bool removeElementData ( element theElement, string key )  
bool removeElementData ( element theElement, string key )  
</syntaxhighlight>  
</syntaxhighlight>  
{{OOP||[[element]]:removeData||}}


===Required Arguments===  
===Required Arguments===  
Line 16: Line 19:


==Example==  
==Example==  
<section class="server" name="Example" show="true">
This will set element data for player which spawned, and then remove it on death.
This will create an element data for know if a player has spawned.
<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)
</section>
</syntaxhighlight>


==See Also==
==See Also==
{{Element_functions}}
{{Element_functions}}
[[Category:Needs Example]]

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


Retrieved from "https://wiki.multitheftauto.com/wiki/RemoveElementData?oldid=78258"