json.contains: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page Json.contains to json.contains: Converting page titles to lowercase)
No edit summary
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}}



Revision as of 18:44, 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.