getAllPlayerNames: Difference between revisions
Jump to navigation
Jump to search
Verisimilar (talk | contribs) m (Macros:Functions:getAllPlayerNames moved to getAllPlayerNames) |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 2: | Line 2: | ||
|name=getAllPlayerNames | |name=getAllPlayerNames | ||
|trusted=true | |trusted=true | ||
|version=1.3b48 | |||
|description=Gets a [[Macros:string list|string list]] containing the names of all the players that are connected. | |description=Gets a [[Macros:string list|string list]] containing the names of all the players that are connected. | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getAllPlayerNames() | |||
getAllPlayerNames(delim) | |||
</ | </syntaxhighlight> | ||
If delim is specified then it is used to separate the values in the list | 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]]. | ||
|example= | |example= | ||
You can use the following code to print | You can use the following code to print the names of all of the players that are connected. | ||
< | <syntaxhighlight 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] | ||
</ | </syntaxhighlight> | ||
}} | }} | ||
[[Category:Miscellaneous Function]] | [[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]