json.count: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Minor formatting changes, corrected examples, added see also.)
No edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 3: Line 3:
|version=1.3b53
|version=1.3b53
|description=
|description=
Returns the number of occurrences of a value in a [[JSON Array]]. If the value does
Returns the number of occurrences of a value in a [[JSON Array]]. If the value does not occur in the [[JSON Array]] then {{code|0}} is returned. The index for the [[JSON Array]] starts at {{code|0}}.
not occur in the [[JSON Array]] then {{code|-1}} is returned. The index for the [[JSON Array]]
starts at {{code|0}}.


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.count(array, value)]
json.count(array, value)]
</source>
</syntaxhighlight>
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.count(array, value, start)]
json.count(array, value, start)]
</source>
</syntaxhighlight>
'''Parameters'''
'''Parameters'''
{{param|array|The [[JSON Array]] to search.}}
{{param|array|The [[JSON Array]] to search.}}
Line 21: Line 19:
|example=
|example=
Find the number of occurrences of {{code|1}}:
Find the number of occurrences of {{code|1}}:
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[r: json.count("[1,2,3,1,1,3]", 1)]
[r: json.count("[1,2,3,1,1,3]", 1)]
</source>
</syntaxhighlight>
Returns {{code|3}}
Returns {{code|3}}


Find the number of occurrences of {{code|1}}, starting at index {{code|1}}:
Find the number of occurrences of {{code|1}}, starting at index {{code|1}}:
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[r: json.count("[1,2,3,1,1,3]", 1, 1)]
[r: json.count("[1,2,3,1,1,3]", 1, 1)]
</source>
</syntaxhighlight>
Returns {{code|2}}
Returns {{code|2}}



Latest revision as of 23:59, 15 March 2023

json.count() Function

Introduced in version 1.3b53
Returns the number of occurrences of a value in a JSON Array. If the value does not occur in the JSON Array then 0 is returned. The index for the JSON Array starts at 0.

Usage

json.count(array, value)]
json.count(array, value, start)]

Parameters

  • array - The JSON Array to search.
  • value - The value to count the occurrences of.
  • start - The index to start searching from, if not specified it defaults to 0.

Example

Find the number of occurrences of 1:
[r: json.count("[1,2,3,1,1,3]", 1)]

Returns 3

Find the number of occurrences of 1, starting at index 1:

[r: json.count("[1,2,3,1,1,3]", 1, 1)]
Returns 2

See Also