AddText (XmlNode function) - Revision history

ELowell: /* Syntax terms */

2015-09-01T23:21:00Z

Syntax terms

← Older revision		Revision as of 23:21, 1 September 2015
Line 6:		Line 6:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%outNod</th>		<tr><th nowrap>%outNod</th>
	<td>If specified, an <var>XmlNode</var> that is set to point to the <var>Text</var> node that is added.</td></tr>		<td>If specified, an <var>XmlNode</var> that is set to point to the <var>Text</var> node that is added.</td></tr>
	<tr><th>nod</th>		<tr><th>nod</th>

JAL: /* Request-cancellation errors */

2014-03-01T01:57:43Z

Request-cancellation errors

← Older revision		Revision as of 01:57, 1 March 2014
Line 52:		Line 52:

	==Request-cancellation errors==		==Request-cancellation errors==
	This list is not exhaustive: it does <i>not</i> include all the errors that are request ~~canceling~~.		This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling.
	<ul>		<ul>
	<li>The <var class="term">nod</var> argument does not point to an <var>Element</var> node.		<li>The <var class="term">nod</var> argument does not point to an <var>Element</var> node.

JAL: /* Request-cancellation errors */

2014-03-01T01:51:55Z

Request-cancellation errors

← Older revision		Revision as of 01:51, 1 March 2014
Line 52:		Line 52:

	==Request-cancellation errors==		==Request-cancellation errors==
			This list is not exhaustive: it does <i>not</i> include all the errors that are request canceling.
	<ul>		<ul>
	<li>The <var class="term">nod</var> argument does not point to an <var>Element</var> node.		<li>The <var class="term">nod</var> argument does not point to an <var>Element</var> node.

	<li><var class="term">nod</var> points to an <var>Element</var> node whose last child is a <var>Text</var> node, and the <var>[[AdjacentText_(XmlDoc_property)\|AdjacentText]]</var> property setting is <code>Disallow</code>.		<li><var class="term">nod</var> points to an <var>Element</var> node whose last child is a <var>Text</var> node, and the <var>[[AdjacentText_(XmlDoc_property)\|AdjacentText]]</var> property setting is <code>Disallow</code>.

	<li>The <var class="term">value</var> argument violates the rules for XML <var>Element</var> content (that is, it contains an invalid character). Note that as of <var class="product">Sirius Mods</var> Version 7.6, this check can no longer be bypassed using the <var>[[InvalidChar (XmlDoc property)\|InvalidChar]]</var> property.		<li>The <var class="term">value</var> argument violates the rules for XML <var>Element</var> content (that is, it contains an invalid character). Note that as of <var class="product">Sirius Mods</var> Version 7.6, this check can no longer be bypassed using the <var>[[InvalidChar (XmlDoc property)\|InvalidChar]]</var> property.

	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JAL at 01:47, 1 March 2014

2014-03-01T01:47:40Z

← Older revision		Revision as of 01:47, 1 March 2014
Line 1:		Line 1:
	{{Template:XmlNode:AddText subtitle}}		{{Template:XmlNode:AddText subtitle}}
	The <var>AddText</var> [[Notation_conventions_for_methods#Callable_methods\|callable]] function adds a ~~<var>~~Text~~</var>~~ node as the last child of the method <var>Element</var> node.		The <var>AddText</var> [[Notation_conventions_for_methods#Callable_methods\|callable]] function adds a [[XmlDoc API#XmlDoc node types\|Text node]] as the last child of the method <var>Element</var> node.

	==Syntax==		==Syntax==

JAL2 at 19:33, 7 August 2012

2012-08-07T19:33:37Z

← Older revision		Revision as of 19:33, 7 August 2012
Line 20:		Line 20:
	<li>As of <var class="product">Sirius Mods</var> Version 7.3, <var class="term">value</var> may include only non-null EBCDIC characters that translate to <var>Unicode</var>. As of <var class="product">Sirius Mods</var> Version 7.6, all <var class="product">[[Janus SOAP]]</var> string arguments and results are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].		<li>As of <var class="product">Sirius Mods</var> Version 7.3, <var class="term">value</var> may include only non-null EBCDIC characters that translate to <var>Unicode</var>. As of <var class="product">Sirius Mods</var> Version 7.6, all <var class="product">[[Janus SOAP]]</var> string arguments and results are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].
	<li>Since the return value of <var>AddText</var> is frequently not needed, you may want to <var>[[Notation_conventions_for_methods#Callable_methods\|Call]]</var> it instead of saving its return value.		<li>Since the return value of <var>AddText</var> is frequently not needed, you may want to <var>[[Notation_conventions_for_methods#Callable_methods\|Call]]</var> it instead of saving its return value.
	<li>To modify the value stored in an <var>Text</var> node, change the <var ~~class="term"~~>Value</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.		<li>To modify the value stored in an <var>Text</var> node, change the <var>Value</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.
	<li>Processing of an <var>XmlDoc</var> is likely to be more efficient if you add nodes in document order (that is, top-to-bottom, left-to-right).		<li>Processing of an <var>XmlDoc</var> is likely to be more efficient if you add nodes in document order (that is, top-to-bottom, left-to-right).
	</ul>		</ul>

JAL2 at 19:21, 31 May 2011

2011-05-31T19:21:27Z

← Older revision		Revision as of 19:21, 31 May 2011
Line 1:		Line 1:
	{{Template:XmlNode:AddText subtitle}}		{{Template:XmlNode:AddText subtitle}}
	The <var>AddText</var> callable function adds a <var>Text</var> node as the last child of the method <var>Element</var> node.		The <var>AddText</var> [[Notation_conventions_for_methods#Callable_methods\|callable]] function adds a <var>Text</var> node as the last child of the method <var>Element</var> node.

	==Syntax==		==Syntax==
Line 16:		Line 16:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If <i>value</i> is the null string, a <var>Text</var> node is not inserted, and <var class="term">%~~nod~~</var> is set to <var>Null</var>.		<li>If <i>value</i> is the null string, a <var>Text</var> node is not inserted, and <var class="term">%outNod</var> is set to <var>Null</var>.
	<li>A <var>Text</var> node may not be added adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.		<li>A <var>Text</var> node may not be added adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.
	<li>As of <var class="product">Sirius Mods</var> Version 7.3, <var class="term">value</var> may include only non-null EBCDIC characters that translate to <var>Unicode</var>. As of <var class="product">Sirius Mods</var> Version 7.6, all <var class="product">[[Janus SOAP~~\|"Janus Soap"~~]]</var> string arguments and results are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].		<li>As of <var class="product">Sirius Mods</var> Version 7.3, <var class="term">value</var> may include only non-null EBCDIC characters that translate to <var>Unicode</var>. As of <var class="product">Sirius Mods</var> Version 7.6, all <var class="product">[[Janus SOAP]]</var> string arguments and results are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].
	<li>Since the return value of <var>AddText</var> is frequently not needed, you may want to <var>[[Notation_conventions_for_methods#Callable_methods\|Call]]</var> it instead of saving its return value.		<li>Since the return value of <var>AddText</var> is frequently not needed, you may want to <var>[[Notation_conventions_for_methods#Callable_methods\|Call]]</var> it instead of saving its return value.
	<li>To modify the value stored in an <var>Text</var> node, change the <var class="term">Value</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.		<li>To modify the value stored in an <var>Text</var> node, change the <var class="term">Value</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.
Line 25:		Line 25:

	==Examples==		==Examples==
	~~<ol><li>~~
	In the following example, a <var>Text</var> node is added as the last child (that is, located after element "b") of element "a":		In the following example, a <var>Text</var> node is added as the last child (that is, located after element "b") of element "a":
	<p class="code">begin		<p class="code">begin
Line 50:		Line 49:
	</a>		</a>
	</top></nowiki>		</top></nowiki>
	</p~~></ol~~>		</p>

	==Request-~~Cancellation Errors~~==		==Request-cancellation errors==
	<ul>		<ul>
	<li><var class="term">~~Nod~~</var> does not point to an <var>Element</var> node.		<li>The <var class="term">nod</var> argument does not point to an <var>Element</var> node.
	<li><var class="term">~~Nod~~</var> points to an <var>Element</var> node whose last child is a <var>Text</var> node, and the <var>[[AdjacentText_(XmlDoc_property)\|AdjacentText]]</var> property setting is <code>Disallow</code>.		<li><var class="term">nod</var> points to an <var>Element</var> node whose last child is a <var>Text</var> node, and the <var>[[AdjacentText_(XmlDoc_property)\|AdjacentText]]</var> property setting is <code>Disallow</code>.
	<li><var class="term">~~Value~~</var> violates the rules for XML <var>Element</var> content (that is, it contains an invalid character). Note that as of <var class="product">[[Sirius Mods~~\|Sirius Mods]]~~</var> Version 7.6, this check can no longer be bypassed using the <var>[[InvalidChar (XmlDoc property)\|InvalidChar]]</var> property.		<li>The <var class="term">value</var> argument violates the rules for XML <var>Element</var> content (that is, it contains an invalid character). Note that as of <var class="product">Sirius Mods</var> Version 7.6, this check can no longer be bypassed using the <var>[[InvalidChar (XmlDoc property)\|InvalidChar]]</var> property.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JALWiccan: 1 revision

2011-05-24T21:09:58Z

1 revision

← Older revision	Revision as of 21:09, 24 May 2011
(No difference)

JALWiccan: 1 revision

2011-05-24T21:09:57Z

1 revision

← Older revision		Revision as of 21:09, 24 May 2011
Line 18:		Line 18:
	<li>If <i>value</i> is the null string, a <var>Text</var> node is not inserted, and <var class="term">%nod</var> is set to <var>Null</var>.		<li>If <i>value</i> is the null string, a <var>Text</var> node is not inserted, and <var class="term">%nod</var> is set to <var>Null</var>.
	<li>A <var>Text</var> node may not be added adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.		<li>A <var>Text</var> node may not be added adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.
	<li>As of <var class="product">"Sirius Mods"</var> Version 7.3, <var class="term">value</var> may include only non-null EBCDIC characters that translate to <var>Unicode</var>. As of <var class="product">"Sirius Mods"</var> Version 7.6, all <var class="product">[[Janus SOAP\|"Janus Soap"]]</var> string arguments and results are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].		<li>As of <var class="product">Sirius Mods</var> Version 7.3, <var class="term">value</var> may include only non-null EBCDIC characters that translate to <var>Unicode</var>. As of <var class="product">Sirius Mods</var> Version 7.6, all <var class="product">[[Janus SOAP\|"Janus Soap"]]</var> string arguments and results are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].
	<li>Since the return value of <var>AddText</var> is frequently not needed, you may want to <var>[[Notation_conventions_for_methods#Callable_methods\|Call]]</var> it instead of saving its return value.		<li>Since the return value of <var>AddText</var> is frequently not needed, you may want to <var>[[Notation_conventions_for_methods#Callable_methods\|Call]]</var> it instead of saving its return value.
	<li>To modify the value stored in an <var>Text</var> node, change the <var class="term">Value</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.		<li>To modify the value stored in an <var>Text</var> node, change the <var class="term">Value</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.

JALWiccan: 1 revision

2011-05-04T17:45:40Z

1 revision

← Older revision	Revision as of 17:45, 4 May 2011
(No difference)

Goff: move footer template to actual end (otherwise subsequent intervening text gets omitted); edits, tags and links

2011-05-04T17:45:39Z

move footer template to actual end (otherwise subsequent intervening text gets omitted); edits, tags and links

← Older revision		Revision as of 17:45, 4 May 2011
Line 11:		Line 11:
	<td>An <var>XmlNode</var> that points to the <var>Element</var> node parent of the inserted <var>Text</var> node.</td></tr>		<td>An <var>XmlNode</var> that points to the <var>Element</var> node parent of the inserted <var>Text</var> node.</td></tr>
	<tr><th>value</th>		<tr><th>value</th>
	<td>The content of the <var>Text</var> node. This <var>Unicode</var> string value is stored without any normalization, entity substitution, etc. Prior to <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6, this is an EBCDIC string.</td></tr>		<td>The content of the <var>Text</var> node. This <var>Unicode</var> string value is stored without any normalization, entity substitution, etc. Prior to <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</td></tr>
	</table>		</table>

Line 56:		Line 56:
	<li><var class="term">Nod</var> does not point to an <var>Element</var> node.		<li><var class="term">Nod</var> does not point to an <var>Element</var> node.
	<li><var class="term">Nod</var> points to an <var>Element</var> node whose last child is a <var>Text</var> node, and the <var>[[AdjacentText_(XmlDoc_property)\|AdjacentText]]</var> property setting is <code>Disallow</code>.		<li><var class="term">Nod</var> points to an <var>Element</var> node whose last child is a <var>Text</var> node, and the <var>[[AdjacentText_(XmlDoc_property)\|AdjacentText]]</var> property setting is <code>Disallow</code>.
	<li><var class="term">Value</var> violates the rules for XML <var>Element</var> content (that is, it contains an invalid character). Note that as of <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6, this check can no longer be bypassed using the <var>[[InvalidChar (XmlDoc property)\|InvalidChar]]</var> property.		<li><var class="term">Value</var> violates the rules for XML <var>Element</var> content (that is, it contains an invalid character). Note that as of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, this check can no longer be bypassed using the <var>[[InvalidChar (XmlDoc property)\|InvalidChar]]</var> property.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>