ToString (Json function) - Revision history

ELowell: /* Syntax terms */

2016-08-23T16:04:07Z

Syntax terms

← Older revision		Revision as of 16:04, 23 August 2016
Line 5:		Line 5:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%unicode</th><td>A unicode string that contains the JSON format serialization of the Json object tree.</td></tr>		<tr><th nowrap>%unicode</th><td>A unicode string that contains the JSON format serialization of the Json object tree.</td></tr>
	<tr><th>Json</th>		<tr><th>Json</th>
	<td>Json object, which may be <var>Null</var> or any underlying Json object type (boolean, number, string, array, or object).</td></tr>		<td>Json object, which may be <var>Null</var> or any underlying Json object type (boolean, number, string, array, or object).</td></tr>
Line 11:		Line 11:
	<td>The number of space characters to add in front of each line for each nesting level (see below for moe details). The default value of <var>Indent</var> is 0 which means lines won't be indented.</td></tr>		<td>The number of space characters to add in front of each line for each nesting level (see below for moe details). The default value of <var>Indent</var> is 0 which means lines won't be indented.</td></tr>
	</table>		</table>

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

Alex: /* Usage notes */

2015-04-18T20:32:23Z

Usage notes

← Older revision		Revision as of 20:32, 18 April 2015
Line 14:		Line 14:
	<ul>		<ul>
	<li>The name <i>ToString</i> is the method name used to do implicit conversion of an object to a string for printing or auditing. So <code>print %json:toString</code> is identical to <code>print %json</code>. ToString is only really needed when one wishes to specify an <var>Indent</var> value.</li>		<li>The name <i>ToString</i> is the method name used to do implicit conversion of an object to a string for printing or auditing. So <code>print %json:toString</code> is identical to <code>print %json</code>. ToString is only really needed when one wishes to specify an <var>Indent</var> value.</li>
	<li>The functionality of ToString is practically identical to that of [[Stringify (Json function)\|Stringify]]. The only difference is that Stringify cancels the request if the Json object leads to a [[Json class#Circular references\|circular reference]]. Because the JSON specification does not allow for circular references, Stringify is probably the preferred function to use for generating JSON to send to another platform – it's better to request cancel in 204 than to send bad JSON data to someone else. ToString displays a circular reference as the unicode literal <code>[Circular]</code> which is probably OK for debugging purposes but would not be ~~derializable~~.</li>		<li>The functionality of ToString is practically identical to that of [[Stringify (Json function)\|Stringify]]. The only difference is that Stringify cancels the request if the Json object leads to a [[Json class#Circular references\|circular reference]]. Because the JSON specification does not allow for circular references, Stringify is probably the preferred function to use for generating JSON to send to another platform – it's better to request cancel in 204 than to send bad JSON data to someone else. ToString displays a circular reference as the unicode literal <code>[Circular]</code> which is probably OK for debugging purposes but would not be deserializable.</li>
	<li>If no indentation is used (<var>Indent</var> defaults or is set to 0) no whitespace is added between any of the JSON tokens and separator characters (curly and square braces, commas, and colons). This format is very compact but can be tough for humans to read.</li>		<li>If no indentation is used (<var>Indent</var> defaults or is set to 0) no whitespace is added between any of the JSON tokens and separator characters (curly and square braces, commas, and colons). This format is very compact but can be tough for humans to read.</li>
	<li>If indentation is used, a [http://en.wikipedia.org/wiki/Newline unicode linefeed character] (u+000a) is added before each array item or object property and after the last array item or object property. If the unicode data is printed or audited, the unicode linefeed characters will cause a new line to be started on the screen or audit trail. This will make the serialized JSON data much nicer and easier to read.</li>		<li>If indentation is used, a [http://en.wikipedia.org/wiki/Newline unicode linefeed character] (u+000a) is added before each array item or object property and after the last array item or object property. If the unicode data is printed or audited, the unicode linefeed characters will cause a new line to be started on the screen or audit trail. This will make the serialized JSON data much nicer and easier to read.</li>

Alex at 00:52, 19 February 2015

2015-02-19T00:52:09Z

@@ Line 1: / Line 1: @@
 {{Template:Json:ToString subtitle}}
+This function serializes a Json object tree as a unicode JSON string.
 ==Syntax==
 {{Template:Json:ToString syntax}}
 ===Syntax terms===
 <table class="syntaxTable">
-<tr><th>%unicode</th><td>Unicode</td></tr>
+<tr><th>%unicode</th><td>A unicode string that contains the JSON format serialization of the Json object tree.</td></tr>
 <tr><th>Json</th>
-<td>Json object, which may be <var>Null</var></td></tr>
+<td>Json object, which may be <var>Null</var> or any underlying Json object type (boolean, number, string, array, or object).</td></tr>
 <tr><th><var>Indent</var></th>
-<td>number<br/>This default value of this argument is [[??]].</td></tr>
+<td>The number of space characters to add in front of each line for each nesting level (see below for moe details). The default value of <var>Indent</var> is 0 which means lines won't be indented.</td></tr>
 </table>
 ==Usage notes==
 ==Examples==
 ==See also==
 {{Template:Json:ToString footer}}

Wiccan: Automatically generated page update

2015-02-17T17:20:11Z

Automatically generated page update

New page

{{Template:Json:ToString subtitle}}

This page is [[under construction]].
==Syntax==
{{Template:Json:ToString syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%unicode</th><td>Unicode</td></tr>
<tr><th>Json</th>
<td>Json object, which may be <var>Null</var></td></tr>
<tr><th><var>Indent</var></th>
<td>number<br/>This default value of this argument is [[??]].</td></tr>
</table>
==Usage notes==
==Examples==
==See also==
{{Template:Json:ToString footer}}