json.contains: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Updated with recent version changes.)
No edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 6: Line 6:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.contains(object, key)
json.contains(object, key)
</source>
</syntaxhighlight>
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.contains(array, value)
json.contains(array, value)
</source>
</syntaxhighlight>
'''Parameters'''
'''Parameters'''
{{param|object|The [[JSON Object]] to test for the key.}}
{{param|object|The [[JSON Object]] to test for the key.}}
Line 20: Line 20:
|examples=
|examples=
Check if the [[JSON Object]] {{code|a}} contains the key {{code|"b"}}:
Check if the [[JSON Object]] {{code|a}} contains the key {{code|"b"}}:
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:a=json.fromStrProp("a=1;b=44;c=12")]
[h:a=json.fromStrProp("a=1;b=44;c=12")]
[json.contains(a,"b")]
[json.contains(a,"b")]
</source>
</syntaxhighlight>
Returns {{true}}
Returns {{true}}


Check if the [[JSON Object]] {{code|a}} contains the key {{code|"z"}}:
Check if the [[JSON Object]] {{code|a}} contains the key {{code|"z"}}:
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:a=json.fromStrProp("a=1;b=44;c=12")]
[h:a=json.fromStrProp("a=1;b=44;c=12")]
[json.contains(a,"z")]
[json.contains(a,"z")]
</source>
</syntaxhighlight>
Returns {{false}}
Returns {{false}}


Check if the [[JSON Array]] {{code|a}} contains the value {{code|"b"}}:
Check if the [[JSON Array]] {{code|a}} contains the value {{code|"b"}}:
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:a=json.fromList("1,b,3,d")]
[h:a=json.fromList("1,b,3,d")]
[json.contains(a,"b")]
[json.contains(a,"b")]
</source>
</syntaxhighlight>
Returns {{true}}
Returns {{true}}



Latest revision as of 23:59, 15 March 2023

json.contains() Function

Introduced in version 1.3b49
Returns true(1) if the JSON Object contains the specified key, or if the JSON Array contains the specified value.

Usage

json.contains(object, key)
json.contains(array, value)

Parameters

  • object - The JSON Object to test for the key.
  • key - The key to check the object for.
  • array - The JSON Array to test for the value.
  • value - The value to check the array for.

Examples

Check if the JSON Object a contains the key "b":
[h:a=json.fromStrProp("a=1;b=44;c=12")]
[json.contains(a,"b")]

Returns true(1)

Check if the JSON Object a contains the key "z":

[h:a=json.fromStrProp("a=1;b=44;c=12")]
[json.contains(a,"z")]

Returns false(0)

Check if the JSON Array a contains the value "b":

[h:a=json.fromList("1,b,3,d")]
[json.contains(a,"b")]
Returns true(1)

See Also

Version Changes

  • 1.3b51 - Added ability for function to work with JSON Arrays.