currentToken: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<source" to "<syntaxhighlight")
 
(15 intermediate revisions by 7 users not shown)
Line 1: Line 1:
==Function currentToken==
{{MacroFunction
{{ProposedChange}}
|name=currentToken
{{TrustedOnlyFunction}}
|version=1.3b48
|description=Returns the id of the [[Current Token]]. In most cases this will return the same as [[Macros:Functions:getImpersonated | getImpersonated()]] function. The difference is when it is called in a {{roll|token}} or after a call to the  [[Macros:Functions:switchToken | switchToken()]] function, in both these cases it will return the id of the [[token]] being operated on, while [[Macros:Functions:getImpersonated | getImpersonated()]] will return the id of the [[impersonated token]].


Returns the id of the current [[token]]. In most cases this will return the same as [[Macros:Functions:getImpersonated | getImpersonated()]] function. The difference is when it is called in a [[Macros:Rolls:token | [token(): ] ]] or after a call to the  [[Macros:Functions:switchToken | switchToken()]] function, in both these cases it will return the id of the [[token]] being operated on, while [[Macros:Functions:getImpersonated | getImpersonated()]] will return the id of the [[impersonated token]].
|usage=
===Usage===
<syntaxhighlight lang="mtmacro" line>
<source lang="mtmacro" line>
currentToken()
[h: tokenId = currentToken()]
</syntaxhighlight>
</source>
'''Parameters''' 
 
None.
 
|examples=
Get the Token ID of the [[Current Token]].
<syntaxhighlight lang="mtmacro" line>
[r:id = currentToken()]
</syntaxhighlight>
 
|also=
[[getImpersonated|getImpersonated()]],
 
|changes=
{{change|1.3b51|No longer a trusted function.}}
 
}}
[[Category:Token Function]]

Latest revision as of 21:00, 14 March 2023

currentToken() Function

Introduced in version 1.3b48
Returns the id of the Current Token. In most cases this will return the same as getImpersonated() function. The difference is when it is called in a [token():] or after a call to the switchToken() function, in both these cases it will return the id of the token being operated on, while getImpersonated() will return the id of the impersonated token.

Usage

currentToken()

Parameters

None.

Examples

Get the Token ID of the Current Token.
[r:id = currentToken()]

See Also

Version Changes

  • 1.3b51 - No longer a trusted function.