Json class - Revision history

Dme at 20:13, 26 April 2018

2018-04-26T20:13:21Z

← Older revision		Revision as of 20:13, 26 April 2018
Line 12:		Line 12:
	<var>Json</var> objects are typically created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A <var>Json</var> object tree can be examined and manipulated using a set of <var>Json</var> functions, and the resulting object tree can be serialized as a string. The <var>Json</var> parsing and serialization functions operate only on Unicode, so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].		<var>Json</var> objects are typically created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A <var>Json</var> object tree can be examined and manipulated using a set of <var>Json</var> functions, and the resulting object tree can be serialized as a string. The <var>Json</var> parsing and serialization functions operate only on Unicode, so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].

	<p class="note"><b>~~Note~~:</b> One slight oddity in the JSON support is that JSON variable names, unlike any other variable names, cannot contain a period. So <code>%my.json.variable</code> is not a valid JSON variable name. </p>		<blockquote class="note"><b>Notes:</b>
			<ul>
			<li>One slight oddity in the JSON support is that JSON variable names, unlike any other variable names, cannot contain a period. So <code>%my.json.variable</code> is not a valid JSON variable name.
			<li>The Json class is new in version 7.6 of Model 204.
			</ul>
			</blockquote>

	==JsonType enumeration==		==JsonType enumeration==

JAL: /* Inheritance */ word change

2016-12-13T17:58:13Z

Inheritance: word change

← Older revision		Revision as of 17:58, 13 December 2016
Line 113:		Line 113:

	==Inheritance==		==Inheritance==
	~~While~~ it is technically possible to create a class that extends the <var>Json</var> class, it is impossible to do much that is useful with such an extension class, because the <var>Json</var> class has no true constructors, only factory methods.		Although it is technically possible to create a class that extends the <var>Json</var> class, it is impossible to do much that is useful with such an extension class, because the <var>Json</var> class has no true constructors, only factory methods.

	==List of Json methods==		==List of Json methods==

JAL: minor wordsmithing

2016-12-13T17:57:06Z

minor wordsmithing

← Older revision		Revision as of 17:57, 13 December 2016
Line 93:		Line 93:
	<p class="code">%json=[13,99,44,["Hickory","Dickory","Doc"]]		<p class="code">%json=[13,99,44,["Hickory","Dickory","Doc"]]
	</p>		</p>
	However, if ~~one~~ then did the following, creating a circular reference to the array object:		However, if you then did the following, creating a circular reference to the array object:
	<p class="code">%json(4):add(%json)		<p class="code">%json(4):add(%json)
	</p>		</p>
Line 101:		Line 101:
	While alright for debugging purposes, this is clearly not an ideal serialization, because:		While alright for debugging purposes, this is clearly not an ideal serialization, because:
	<ul>		<ul>
	<li>It provides no indication of what <~~var~~>[Circular]</~~var~~> refers. </li>		<li>It provides no indication of what <code>[Circular]</code> refers to. </li>

	<li>For complex object forests, there could be several <var>[Circular]</var> references, each of which might refer to a different object or array. </li>		<li>For complex object forests, there could be several <var>[Circular]</var> references, each of which might refer to a different object or array. </li>
Line 113:		Line 113:

	==Inheritance==		==Inheritance==
	While it is technically possible to create a class that extends the <var>Json</var> class, ~~since~~ the <var>Json</var> class has no true constructors, only factory methods~~, it is impossible to really do much useful with such an extension class~~.		While it is technically possible to create a class that extends the <var>Json</var> class, it is impossible to do much that is useful with such an extension class, because the <var>Json</var> class has no true constructors, only factory methods.

	==List of Json methods==		==List of Json methods==

JAL: misc formatting

2016-12-09T02:35:39Z

misc formatting

Show changes

Admin at 04:08, 30 September 2015

2015-09-30T04:08:39Z

← Older revision		Revision as of 04:08, 30 September 2015
Line 11:		Line 11:
	Json objects would typically be created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A Json object tree can be examined and manipulated using a set of Json functions and the resulting object tree can be serialized as a string. The Json parsing and serialization functions operate only on unicode so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].		Json objects would typically be created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A Json object tree can be examined and manipulated using a set of Json functions and the resulting object tree can be serialized as a string. The Json parsing and serialization functions operate only on unicode so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].

	One slight oddity in the JSON support is that JSON variable names, unlike any other variable names, cannot contain a period. So <code>%my.json.variable</code> is not a ~~vlid~~ JSON variable name.		One slight oddity in the JSON support is that JSON variable names, unlike any other variable names, cannot contain a period. So <code>%my.json.variable</code> is not a valid JSON variable name.

	==JsonType enumeration==		==JsonType enumeration==

Admin at 04:07, 30 September 2015

2015-09-30T04:07:20Z

← Older revision		Revision as of 04:07, 30 September 2015
Line 10:		Line 10:

	Json objects would typically be created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A Json object tree can be examined and manipulated using a set of Json functions and the resulting object tree can be serialized as a string. The Json parsing and serialization functions operate only on unicode so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].		Json objects would typically be created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A Json object tree can be examined and manipulated using a set of Json functions and the resulting object tree can be serialized as a string. The Json parsing and serialization functions operate only on unicode so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].

			One slight oddity in the JSON support is that JSON variable names, unlike any other variable names, cannot contain a period. So <code>%my.json.variable</code> is not a vlid JSON variable name.

	==JsonType enumeration==		==JsonType enumeration==

ELowell: /* The JsonType enumeration */

2015-06-17T18:59:15Z

The JsonType enumeration

← Older revision		Revision as of 18:59, 17 June 2015
Line 11:		Line 11:
	Json objects would typically be created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A Json object tree can be examined and manipulated using a set of Json functions and the resulting object tree can be serialized as a string. The Json parsing and serialization functions operate only on unicode so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].		Json objects would typically be created either programmatically using JSON constructors or by parsing a JSON string sent from another platform. A Json object tree can be examined and manipulated using a set of Json functions and the resulting object tree can be serialized as a string. The Json parsing and serialization functions operate only on unicode so a separate step is required to encode/decode the data to/from a format suitable for network transfer, most commonly [http://en.wikipedia.org/wiki/UTF-8 UTF-8].

	==~~The~~ JsonType enumeration==		==JsonType enumeration==
	The <var>JsonType</var> [[Enumerations\|enumeration]] indicates the type of JSON data represented by a Json object. Json objects simulate JavaScript variables in that they are untyped so that the same variable can actually reference very different datatypes.		The <var>JsonType</var> [[Enumerations\|enumeration]] indicates the type of JSON data represented by a Json object. Json objects simulate JavaScript variables in that they are untyped so that the same variable can actually reference very different datatypes.

ELowell: /* Implicit conversions */

2015-06-11T22:18:24Z

Implicit conversions

← Older revision		Revision as of 22:18, 11 June 2015
Line 29:		Line 29:
	A Json object can represent a number or a string.		A Json object can represent a number or a string.

	The variable name for a ~~JSON~~ object follows the naming conventions for SOUL variables except that it cannot contain a period.		The variable name for a Json object follows the naming conventions for SOUL variables except that it cannot contain a period.

	To create a Json string object one can use the [[String (Json function)\|String function]] and to create a Json number object one can use the [[Number (Json function)\|Number function]]:		To create a Json string object one can use the [[String (Json function)\|String function]] and to create a Json number object one can use the [[Number (Json function)\|Number function]]:

ELowell: /* Implicit conversions */

2015-06-11T22:11:01Z

Implicit conversions

← Older revision		Revision as of 22:11, 11 June 2015
Line 27:		Line 27:

	==Implicit conversions==		==Implicit conversions==
	A Json object can represent a number or a string. To create a Json string object one can use the [[String (Json function)\|String function]] and to create a Json number object one can use the [[Number (Json function)\|Number function]]:		A Json object can represent a number or a string.

			The variable name for a JSON object follows the naming conventions for SOUL variables except that it cannot contain a period.

			To create a Json string object one can use the [[String (Json function)\|String function]] and to create a Json number object one can use the [[Number (Json function)\|Number function]]:
	<p class="code">%json is object json		<p class="code">%json is object json
	...		...
Line 63:		Line 67:
	And, since comparisons return a numeric value, if one wants to assign the result of a comparison to a Json object as a boolean, one must do something like:		And, since comparisons return a numeric value, if one wants to assign the result of a comparison to a Json object as a boolean, one must do something like:
	<p class="code">%json = boolean(%war eq %peace)		<p class="code">%json = boolean(%war eq %peace)
	</p>		</p>

	==Circular references==		==Circular references==
	Json objects can have circular references also known as cycles in O-O terms. For example, one can create an array as:		Json objects can have circular references also known as cycles in O-O terms. For example, one can create an array as:

Dme: /* Circular references */

2015-05-03T11:30:23Z

Circular references

← Older revision		Revision as of 11:30, 3 May 2015
Line 77:		Line 77:
	<p class="code">%json(4):add(%json)		<p class="code">%json(4):add(%json)
	</p>		</p>
	creating a circular reference to the array object, printing ~~or serialize~~ the object results in a		creating a circular reference to the array object; printing the object results in
	<p class="code">%json=[13,99,44,["Hickory","Dickory","Doc",[Circular]]]		<p class="code">%json=[13,99,44,["Hickory","Dickory","Doc",[Circular]]]
	</p>		</p>