getAllPlayerNames: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<source" to "<syntaxhighlight")
 
(7 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=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: player = getAllPlayerNames()]
getAllPlayerNames()
[h: player = getAllPlayerNames(delim)]
getAllPlayerNames(delim)
</source>
</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 ','.
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 out all of the players that are connected.
You can use the following code to print the names of all of the players that are connected.
<source lang="mtmacro" line>
<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]
</source>
</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]