getAllPlayerNames: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<source" to "<syntaxhighlight")
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==Function encode==
{{MacroFunction
{{ProposedChange}}
|name=getAllPlayerNames
{{TrustedOnlyFunction}}
|trusted=true
|version=1.3b48
|description=Gets a [[Macros:string list|string list]] containing the names of all the players that are connected.


Gets a [[Macros:string list|] containing the names of all the players that are connected.
|usage=
<syntaxhighlight lang="mtmacro" line>
getAllPlayerNames()
getAllPlayerNames(delim)
</syntaxhighlight>


===Usage===
If {{code|delim}} is specified then it is used to separate the values in the list; if it is not specified then it defaults to "{{code|,}}".  When {{code|delim}} is the string "{{code|json}}" the return value will be in the form of a [[JSON Array]].
<source lang="mtmacro" line>
[h: player = getAllPlayerNames()]
[h: player = getAllPlayerNames(delim)]
</source>


If delim is specified then it is used to separate the values in the list, if it is not specified then it defaults to ','.
|example=
 
You can use the following code to print the names of all of the players that are connected.
===Examples===
<syntaxhighlight lang="mtmacro" line>
You can use the following code to print out all of the players that are connected.
<source lang="mtmacro" line>
Players Connected<br>
Players Connected<br>
[h: players = getAllPlayerNames()]
[h: players = getAllPlayerNames()]
[foreach(name, players, "<br>"): name]
[foreach(name, players, "<br>"): name]
</source>
</syntaxhighlight>
}}
[[Category:Miscellaneous Function]]

Latest revision as of 23:59, 14 March 2023

getAllPlayerNames() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.3b48
Gets a string list containing the names of all the players that are connected.

Usage

getAllPlayerNames()
getAllPlayerNames(delim)

If delim is specified then it is used to separate the values in the list; if it is not specified then it defaults to ",". When delim is the string "json" the return value will be in the form of a JSON Array.

Example

You can use the following code to print the names of all of the players that are connected.
Players Connected<br>
[h: players = getAllPlayerNames()]
[foreach(name, players, "<br>"): name]