GetElementData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 13: Line 13:


==Example==
==Example==
'''Example 1:''' This example stores the time a player joins and then allows players to see this using a console function 'join_time'.
'''Example 1:''' This example stores the tick count when a player joins and then allows players to see how long they are connected using a console function 'joinTime'.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- Make our 'joinTime' function be called when a player joins
addEventHandler ( "onPlayerJoin", getRootElement(), "joinTime" )
function joinTime ( )
function joinTime ( )
     setElementData ( source, "joinTime", os.date() ) -- Store the current time in the player's data with the key 'joinTime'
     setElementData ( source, "joinTime", getTickCount() ) -- Store the current tick count in the player's data with the key 'joinTime'
end
end
-- Make our 'joinTime' function be called when a player joins
addEventHandler ( "onPlayerJoin", getRootElement(), joinTime )


-- Add a console command join_time, that takes an optional parameter of a player's name
addCommandHandler ( "join_time", "showJoinTime" )
function showJoinTime ( source, commandName, playerName )
function showJoinTime ( source, commandName, playerName )
     if ( playerName ) then -- see if a player was specified
     if ( playerName ) then -- see if a player was specified
         thePlayer = getPlayerFromNick ( playerName ) -- get the player element for the specified player
         thePlayer = getPlayerFromNick ( playerName ) -- get the player element for the specified player
         if ( thePlayer ) then -- if one was found...
         if ( thePlayer ) then -- if one was found...
             outputChatBox ( getClientName ( thePlayer ) .. " joined " .. getElementData ( thePlayer, "joinTime" ), source ) -- output the player's join time
local timeOnline = (getTickCount() - getElementData ( thePlayer, "joinTime" )) / 1000 -- calculates the time since join
             outputChatBox ( getClientName ( thePlayer ).." joined "..timeOnline.." seconds ago", source ) -- output the player's join time
         else
         else
             outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- display an error
             outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- display an error
Line 33: Line 32:
     else
     else
         -- display when the player who used the function joined and inform how to see other people's join time
         -- display when the player who used the function joined and inform how to see other people's join time
         outputChatBox ( "You joined " .. getElementData ( source, "joinTime" ), source )
local timeOnline = (getTickCount() - getElementData ( source, "joinTime" )) / 1000 -- calculate the time since join
         outputChatBox ( "Use 'join_time <player name>' to see other people's join time" )
         outputChatBox ( "You joined " ..timeOnline.." seconds ago", source )
         outputChatBox ( "Use 'join_time <player name>' to see other people's join time", source )
     end
     end
end
end
-- Add a console command joinTime, that takes an optional parameter of a player's name
addCommandHandler ( "joinTime", showJoinTime )
</syntaxhighlight>
</syntaxhighlight>
<!--
'''Example 2:''' This example will store the version of the map in the variable ''mapVersion''. Generally this will be ''2.0'' in the final release.
'''Example 2:''' This example will store the version of the map in the variable ''mapVersion''. Generally this will be ''2.0'' in the final release.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 43: Line 46:
mapVersion = getElementData ( map, "version" )
mapVersion = getElementData ( map, "version" )
</syntaxhighlight>
</syntaxhighlight>
 
-->
==See Also==
==See Also==
{{Element functions}}
{{Element functions}}

Revision as of 13:28, 29 July 2007

Elements can contain data values. These are accessable via names, and their value can be retrieved using getElementData and set using setElementData. These values are also loaded from the attributes in the XML map files, and as such can provide a powerful way to store and retrieve data in XML for each element.

Syntax

var getElementData ( element theElement, string key )

Required Arguments

  • theElement: This is the element with data you want to retreive.
  • key: The name of the element data entry you want to retrieve.

Returns

This function returns a variable containing the requested element data, or false if the element data does not exist, or the element itself does not exist. Usually this is a string but it doesn't have to be.

Example

Example 1: This example stores the tick count when a player joins and then allows players to see how long they are connected using a console function 'joinTime'. 

function joinTime ( )
    setElementData ( source, "joinTime", getTickCount() ) -- Store the current tick count in the player's data with the key 'joinTime'
end
-- Make our 'joinTime' function be called when a player joins
addEventHandler ( "onPlayerJoin", getRootElement(), joinTime )

function showJoinTime ( source, commandName, playerName )
    if ( playerName ) then -- see if a player was specified
        thePlayer = getPlayerFromNick ( playerName ) -- get the player element for the specified player
        if ( thePlayer ) then -- if one was found...
			local timeOnline = (getTickCount() - getElementData ( thePlayer, "joinTime" )) / 1000 -- calculates the time since join
            outputChatBox ( getClientName ( thePlayer ).." joined "..timeOnline.." seconds ago", source ) -- output the player's join time
        else
            outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- display an error
        end 
    else
        -- display when the player who used the function joined and inform how to see other people's join time
		local timeOnline = (getTickCount() - getElementData ( source, "joinTime" )) / 1000 -- calculate the time since join
        outputChatBox ( "You joined " ..timeOnline.." seconds ago", source )
        outputChatBox ( "Use 'join_time <player name>' to see other people's join time", source )
    end
end
-- Add a console command joinTime, that takes an optional parameter of a player's name
addCommandHandler ( "joinTime", showJoinTime )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetElementData?oldid=9290"