json.removeFirst: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Fixing the formatting of the example output.)
No edit summary
 
(2 intermediate revisions by one other user not shown)
Line 8: Line 8:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.removeFirst(array1, array2)
json.removeFirst(array1, array2)
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
Line 19: Line 19:


|examples=
|examples=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[json.removeFirst('[2,2,4,5,6,6,4]', '[2,6]')]
[json.removeFirst('[2,2,4,5,6,6,4]', '[2,6]')]
</source>
</syntaxhighlight>
'''Outputs:'''
'''Outputs:'''
<pre>  [2,4,5,6,4]</pre>
<pre>  [2,4,5,6,4]</pre>
Difference between {{func|json.removeFirst}} and {{func|json.difference}}.
Difference between {{func|json.removeFirst}} and {{func|json.difference}}.
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: a1 = '[1,2,2,2,3,3,4,5,6,6]']
[h: a1 = '[1,2,2,2,3,3,4,5,6,6]']
[h: a2 = '[2,4,6]']
[h: a2 = '[2,4,6]']
Line 32: Line 32:
[h: a1 = '[1,2,2,2,3,3,4,5,6,6]']
[h: a1 = '[1,2,2,2,3,3,4,5,6,6]']
[r: json.removeFirst(a1,a2)]
[r: json.removeFirst(a1,a2)]
</source>
</syntaxhighlight>
'''Outputs:'''
'''Outputs:'''
<pre>  [1,3,5]
<pre>  [1,3,5]

Latest revision as of 16:40, 15 March 2023

json.removeFirst() Function

Introduced in version 1.4.0.3
Is similar to json.difference() but will only remove the first occurrence of a match.

Usage

json.removeFirst(array1, array2)

Parameters

  • array1 - A JSON array.
  • array2 - A JSON array.

Compares the two arrays and removes the first element from the first array matching an element in the second.

Examples

[json.removeFirst('[2,2,4,5,6,6,4]', '[2,6]')]

Outputs:

  [2,4,5,6,4]

Difference between json.removeFirst() and json.difference().

[h: a1 = '[1,2,2,2,3,3,4,5,6,6]']
[h: a2 = '[2,4,6]']
[r: json.difference(a1,a2)]
<!-- a1 has been modified - reset -->
[h: a1 = '[1,2,2,2,3,3,4,5,6,6]']
[r: json.removeFirst(a1,a2)]

Outputs:

  [1,3,5]
  [1,2,2,3,3,5,6]

See Also