InsertTextBefore (XmlNode function) - Revision history

ELowell: /* Syntax terms */

2015-09-02T21:19:59Z

Syntax terms

← Older revision		Revision as of 21:19, 2 September 2015
Line 7:		Line 7:
	===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 inserted. </td></tr>		<td>If specified, an <var>XmlNode</var> that is set to point to the <var>Text</var> node that is inserted. </td></tr>

JAL at 17:34, 3 March 2014

2014-03-03T17:34:25Z

← Older revision		Revision as of 17:34, 3 March 2014
Line 1:		Line 1:
	{{Template:XmlNode:InsertTextBefore subtitle}}		{{Template:XmlNode:InsertTextBefore subtitle}}
	<var>InsertTextBefore</var> inserts a ~~<var>~~Text~~</var>~~ node as the immediate sibling preceding the method <var>XmlNode</var>.		<var>InsertTextBefore</var> inserts a [[XmlDoc API#XmlDoc node types\|Text node]] as the immediate sibling preceding the method <var>XmlNode</var>.

	==Syntax==		==Syntax==
	{{Template:XmlNode:InsertTextBefore syntax}}		{{Template:XmlNode:InsertTextBefore syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%outNod</th>		<tr><th>%outNod</th>
	<td>If specified, an <var>XmlNode</var> that is set to point to the <var>Text</var> node that is inserted. </td></tr>		<td>If specified, an <var>XmlNode</var> that is set to point to the <var>Text</var> node that is inserted. </td></tr>

	<tr><th>nod</th>		<tr><th>nod</th>
	<td><var>XmlNode</var> that points to the node before which the <var>Text</var> node is inserted. The node may be any type except <var>Root</var> or <var>Text</var>.</td></tr>		<td><var>XmlNode</var> that points to the node before which the <var>Text</var> node is inserted. The node may be any type except <var>Root</var> or <var>Text</var>.</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.</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.</td></tr>
Line 50:		Line 53:

	==Request-cancellation errors==		==Request-cancellation errors==
			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> object is the <var>Root</var> node.		<li>The <var class="term">nod</var> object is the <var>Root</var> node.

	<li><var class="term">nod</var> is a <var>Text</var> node, or the sibling following 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> is a <var>Text</var> node, or the sibling following 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> is a child of the <var>Root</var> node.		<li><var class="term">nod</var> is a child of the <var>Root</var> node.

	<li>The <var class="term">value</var> argument violates the rules for XML Element 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</var> method — see the <var>InvalidChar</var> [[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes"]].		<li>The <var class="term">value</var> argument violates the rules for XML Element 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</var> method — see the <var>InvalidChar</var> [[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes"]].

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

JAL2 at 23:58, 31 May 2011

2011-05-31T23:58:26Z

← Older revision		Revision as of 23:58, 31 May 2011
Line 16:		Line 16:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If <var class="term">value</var> 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 <var class="term">value</var> 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>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 Unicode. As of <var class="product">Sirius Mods</var> Version 7.6, all <var class="product">[[Janus SOAP]]</var> string arguments and results are Unicode or are converted to Unicode. 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>InsertTextBefore</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>InsertTextBefore</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>[[Value_(XmlDoc/XmlNode_property)\|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_(XmlDoc/XmlNode_property)\|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 inserted before node "b" (that is, as its immediately preceding sibling):		In the following example, a <var>Text</var> node is inserted before node "b" (that is, as its immediately preceding sibling):
	<p class="code">begin		<p class="code">begin
Line 48:		Line 47:
	</a>		</a>
	</top>		</top>
	</p~~></ol~~>		</p>

	==Request-~~Cancellation Errors~~==		==Request-cancellation errors==
	<ul>		<ul>
	<li><var class="term">~~Nod~~</var> is the <var>Root</var> node.		<li>The <var class="term">nod</var> object is the <var>Root</var> node.
	<li><var class="term">~~Nod~~</var> is a <var>Text</var> node, or the sibling following 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> is a <var>Text</var> node, or the sibling following 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> is a child of the <var>Root</var> node.		<li><var class="term">nod</var> is a child of the <var>Root</var> node.
	<li><var class="term">~~Value~~</var> violates the rules for XML Element 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</var> method &~~amp;amp;~~mdash; see <var>[[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes ~~for the InvalidChar property~~"]]~~</var>~~.		<li>The <var class="term">value</var> argument violates the rules for XML Element 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</var> method — see the <var>InvalidChar</var> [[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes"]].
	<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 17:		Line 17:
	<ul>		<ul>
	<li>If <var class="term">value</var> 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 <var class="term">value</var> 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>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>InsertTextBefore</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>InsertTextBefore</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>[[Value_(XmlDoc/XmlNode_property)\|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_(XmlDoc/XmlNode_property)\|Value]]</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.
Line 55:		Line 55:
	<li><var class="term">Nod</var> is a <var>Text</var> node, or the sibling following 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> is a <var>Text</var> node, or the sibling following 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> is a child of the <var>Root</var> node.		<li><var class="term">Nod</var> is a child of the <var>Root</var> node.
	<li><var class="term">Value</var> violates the rules for XML Element 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</var> method &mdash; see <var>[[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes for the InvalidChar property"]]</var>.		<li><var class="term">Value</var> violates the rules for XML Element 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</var> method &amp;mdash; see <var>[[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes for the InvalidChar property"]]</var>.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JALWiccan: 1 revision

2011-05-24T17:27:08Z

1 revision

← Older revision	Revision as of 17:27, 24 May 2011
(No difference)

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

2011-05-24T17:27:07Z

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

← Older revision		Revision as of 17:27, 24 May 2011
Line 17:		Line 17:
	<ul>		<ul>
	<li>If <var class="term">value</var> 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 <var class="term">value</var> 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>As of <var class="product">[[Sirius Mods~~\|"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>InsertTextBefore</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>InsertTextBefore</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>[[Value_(XmlDoc/XmlNode_property)\|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_(XmlDoc/XmlNode_property)\|Value]]</var> property of an <var>XmlNode</var> that points to the <var>Text</var> node.
Line 55:		Line 55:
	<li><var class="term">Nod</var> is a <var>Text</var> node, or the sibling following 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> is a <var>Text</var> node, or the sibling following 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> is a child of the <var>Root</var> node.		<li><var class="term">Nod</var> is a child of the <var>Root</var> node.
	<li><var class="term">Value</var> violates the rules for XML Element 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</var> method — see <var>[[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes for the InvalidChar property"]]</var>.		<li><var class="term">Value</var> violates the rules for XML Element 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</var> method &mdash; see <var>[[InvalidChar (XmlDoc property)#Usage notes\|"Usage notes for the InvalidChar property"]]</var>.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

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

2011-05-07T05:30:09Z

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

Show changes

Dme at 21:23, 16 February 2011

2011-02-16T21:23:59Z

← Older revision		Revision as of 21:23, 16 February 2011
Line 80:		Line 80:
	Note that as of		Note that as of
	''Sirius Mods'' version 7.6, this check can no longer be bypassed using the InvalidChar		''Sirius Mods'' version 7.6, this check can no longer be bypassed using the InvalidChar
	method — see [[InvalidChar (XmlDoc property)#Usage notes\|Usage ~~Notes~~ for the InvalidChar property]].		method — see [[InvalidChar (XmlDoc property)#Usage notes\|Usage notes for the InvalidChar property]].
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

Dme at 21:23, 16 February 2011

2011-02-16T21:23:40Z

← Older revision		Revision as of 21:23, 16 February 2011
Line 80:		Line 80:
	Note that as of		Note that as of
	''Sirius Mods'' version 7.6, this check can no longer be bypassed using the InvalidChar		''Sirius Mods'' version 7.6, this check can no longer be bypassed using the InvalidChar
	method — see [[InvalidChar (XmlDoc property)#Usage ~~Notes~~\|Usage Notes for the InvalidChar property]].		method — see [[InvalidChar (XmlDoc property)#Usage notes\|Usage Notes for the InvalidChar property]].
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>