Item (Json property) - Revision history

Alan: minor misspelling.

2017-03-23T20:46:36Z

minor misspelling.

← Older revision		Revision as of 20:46, 23 March 2017
Line 1:		Line 1:
	{{Template:Json:Item subtitle}}		{{Template:Json:Item subtitle}}
	This function retrieves of sets an item in a Json array or object, using either the item number for an array or the item (property) name for an object.		This function retrieves or sets an item in a Json array or object, using either the item number for an array or the item (property) name for an object.
	==Syntax==		==Syntax==
	{{Template:Json:Item syntax}}		{{Template:Json:Item syntax}}

ELowell: /* Syntax terms */

2016-08-23T15:52:11Z

Syntax terms

← Older revision		Revision as of 15:52, 23 August 2016
Line 5:		Line 5:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%currentJson</th><td><var>Json</var> object being retrieved from the object or array.</td></tr>		<tr><th nowrap>%currentJson</th><td><var>Json</var> object being retrieved from the object or array.</td></tr>
	<tr><th>Json</th>		<tr><th>Json</th>
	<td><var>Json</var> object, which must be either an object or array.</td></tr>		<td><var>Json</var> object, which must be either an object or array.</td></tr>
Line 12:		Line 12:
	<tr><th>newJson</th><td><var>Json</var> object being added to the object or array.</td></tr>		<tr><th>newJson</th><td><var>Json</var> object being added to the object or array.</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>

Alex: /* Usage notes */

2015-02-18T14:58:58Z

Usage notes

← Older revision		Revision as of 14:58, 18 February 2015
Line 19:		Line 19:
	<li>The names used for objects are always stored internally as unicode so the names can be specified as unicode variables or constants.</li>		<li>The names used for objects are always stored internally as unicode so the names can be specified as unicode variables or constants.</li>
	<li>If the underlying Json object is an object, specifying a name that is not in the object returns a null on a retrieval and adds the name on a set.</li>		<li>If the underlying Json object is an object, specifying a name that is not in the object returns a null on a retrieval and adds the name on a set.</li>
			<li>Unlike NamedArraylists, items are maintained in the object in the order in which they are added – this is generally the way JavaScript works and, while the JSON standard cautions against depending on property order, it does not forbid it. This does mean that setting and retrieving object items (properties) requires a linear scan of the item list so is not an ideal structure for very large item lists.</li>
	<li>If the underlying Json object is an array, the index must specify an item number that is between 1 and the number of items in the array (inclusive) for a retrieval, and between 1 and the number of items in the array plus one (inclusive) for a set. If the item number specified on a set is one more than the number of items in the array, the item is added to the end of the array.</li>		<li>If the underlying Json object is an array, the index must specify an item number that is between 1 and the number of items in the array (inclusive) for a retrieval, and between 1 and the number of items in the array plus one (inclusive) for a set. If the item number specified on a set is one more than the number of items in the array, the item is added to the end of the array.</li>
	<li>If the underlying Json object is an array, the input index is treated as a number, regardless of its datatype. This means that if it's a string that's not a valid number, it's converted to a 0 which is not a valid item number so results in request cancellation.</li>		<li>If the underlying Json object is an array, the input index is treated as a number, regardless of its datatype. This means that if it's a string that's not a valid number, it's converted to a 0 which is not a valid item number so results in request cancellation.</li>
	</ul>		</ul>

	==Examples==		==Examples==
	The following example sets some object items (properties) by name and then retrieves their values to use in an addition:		The following example sets some object items (properties) by name and then retrieves their values to use in an addition:

Alex at 14:44, 18 February 2015

2015-02-18T14:44:02Z

@@ Line 1: / Line 1: @@
 {{Template:Json:Item subtitle}}
+This function retrieves of sets an item in a Json array or object, using either the item number for an array or the item (property) name for an object.
 ==Syntax==
 {{Template:Json:Item syntax}}
 ===Syntax terms===
 <table class="syntaxTable">
-<tr><th>%json</th><td><var>Json</var> object</td></tr>
+<tr><th>%currentJson</th><td><var>Json</var> object being retrieved from the object or array.</td></tr>
 <tr><th>Json</th>
-<td>Json object, which may be <var>Null</var></td></tr>
+<td><var>Json</var> object, which must be either an object or array.</td></tr>
-<tr><th>nonObject</th>
+<tr><th>index</th>
-<td>NonObject</td></tr>
+<td>The number of the item to set or retrieve if the Json object is an array or the name of the item (property) to set or retrieve if the Json object is an object.</td></tr>
 </table>
 ==Usage notes==
 ==Examples==
 ==See also==
 {{Template:Json:Item footer}}

Wiccan: Automatically generated page update

2015-02-17T17:20:06Z

Automatically generated page update

New page

{{Template:Json:Item subtitle}}

This page is [[under construction]].
==Syntax==
{{Template:Json:Item syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%json</th><td><var>Json</var> object</td></tr>
<tr><th>Json</th>
<td>Json object, which may be <var>Null</var></td></tr>
<tr><th>nonObject</th>
<td>NonObject</td></tr>
</table>
==Usage notes==
==Examples==
==See also==
{{Template:Json:Item footer}}