getAllPlayerNames: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page GetAllPlayerNames to getAllPlayerNames: Converting page titles to lowercase) |
m (Text replacement - "source>" to "syntaxhighlight>") |
||
| Line 9: | Line 9: | ||
getAllPlayerNames() | getAllPlayerNames() | ||
getAllPlayerNames(delim) | getAllPlayerNames(delim) | ||
</ | </syntaxhighlight> | ||
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]]. | 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]]. | ||
| Line 19: | Line 19: | ||
[h: players = getAllPlayerNames()] | [h: players = getAllPlayerNames()] | ||
[foreach(name, players, "<br>"): name] | [foreach(name, players, "<br>"): name] | ||
</ | </syntaxhighlight> | ||
}} | }} | ||
[[Category:Miscellaneous Function]] | [[Category:Miscellaneous Function]] | ||
Revision as of 17:11, 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
<source lang="mtmacro" line> getAllPlayerNames() getAllPlayerNames(delim) </syntaxhighlight>
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.
<source lang="mtmacro" line>
Players Connected
[h: players = getAllPlayerNames()]
[foreach(name, players, "
"): name]