json.removeFirst: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Created page with "{{MacroFunction |name=json.removeFirst |proposed=false |trusted=false |version=1.4.0.3 |description:Is similar to json.difference() but will only remove the first occurrence o...")
 
m (Added comparison between difference and removeFirst. Formatting.)
Line 16: Line 16:


Compares the 2nd array with the first array and removes the first element from the first array matching an element in the second.
Compares the 2nd array with the first array and removes the first element from the first array matching an element in the second.
''Example:''<source lang="mtmacro" line>
 
[json.removeFirst('[2,2,4,5,6,6,4]', '[2,6]')] => [2,4,5,6,4]
|examples= <source lang="mtmacro" line>
[json.removeFirst('[2,2,4,5,6,6,4]', '[2,6]')]
</source>
'''Outputs:
[2,4,5,6,4]
Difference between {{func|json.removeFirst}} and {{func|json.difference}}.
<source lang="mtmacro" line>
[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)]
</source>
</source>
'''Outputs:
[1,3,5]
[1,2,2,3,3,5,6]


|also=
|also=
[[Introduction to JSON Datatypes ]], {{func|json.rolls}}
[[Introduction to JSON Datatypes ]], {{func|json.difference}}
[[Category:JSON Function]]
[[Category:JSON Function]]
}}
}}

Revision as of 12:06, 29 August 2018

json.removeFirst() Function

Introduced in version 1.4.0.3

Usage

json.removeFirst(array1, array2)

Parameters

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

Compares the 2nd array with the first array 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