AppendValue (XmlNode subroutine) - Revision history

ELowell: /* Request-cancellation errors */

2015-09-01T18:48:44Z

Request-cancellation errors

← Older revision		Revision as of 18:48, 1 September 2015
Line 38:		Line 38:

	==Request-cancellation errors==		==Request-cancellation errors==
	This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling.		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>XmlNode</var>.		<li>The <var class="term">nod</var> argument does not point to an <var>XmlNode</var>.

JAL: /* Request-cancellation errors */

2014-03-03T17:20:55Z

Request-cancellation errors

← Older revision		Revision as of 17:20, 3 March 2014
Line 38:		Line 38:

	==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> argument does not point to an <var>XmlNode</var>.		<li>The <var class="term">nod</var> argument does not point to an <var>XmlNode</var>.

Dme at 14:09, 13 September 2012

2012-09-13T14:09:39Z

← Older revision		Revision as of 14:09, 13 September 2012
Line 26:		Line 26:
	<p class="code">%n = %x:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('a', 'begin value')		<p class="code">%n = %x:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('a', 'begin value')
	%n:appendValue('_some more_')		%n:appendValue('_some more_')
	[[Text_and_Html_statements#~~The_HTML_or_TEXT_statement~~\|text to]] %sl		[[Text_and_Html_statements#toOption\|text to]] %sl
	and more		and more
	and that's all		and that's all

JAL2 at 21:05, 31 May 2011

2011-05-31T21:05:49Z

← Older revision		Revision as of 21:05, 31 May 2011
Line 23:		Line 23:

	==Example==		==Example==
	~~<ol><li>~~The following fragment appends a <var>Unicode</var> string and then a <var>Stringlist</var> to an <var>Element</var> value:		The following fragment appends a <var>Unicode</var> string and then a <var>Stringlist</var> to an <var>Element</var> value:
	<p class="code">%n = %x:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('a', 'begin value')		<p class="code">%n = %x:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('a', 'begin value')
	%n:appendValue('_some more_')		%n:appendValue('_some more_')
Line 34:		Line 34:
	</p>		</p>
	The result is:		The result is:
	<p class="output"><a>begin value_some more_and more&~~amp;~~amp;#xA;and that's all</a>		<p class="output"><a>begin value_some more_and more&#xA;and that's all</a>
	</p~~></ol~~>		</p>

	==Request-~~Cancellation Errors~~==		==Request-cancellation errors==
	<ul>		<ul>
	<li><var class="term">nod</var> does not point to an <var>XmlNode</var>.		<li>The <var class="term">nod</var> argument does not point to an <var>XmlNode</var>.
	<li><var class="term">nod</var> points to the <var>Root</var> node.		<li><var class="term">nod</var> points to the <var>Root</var> node.
	<li><var class="term">nod</var> points to an <var>Element</var> node that has more than one child, or that has one, non-<var>Text</var> node child.		<li><var class="term">nod</var> points to an <var>Element</var> node that has more than one child, or that has one, non-<var>Text</var> node child.
	<li><var class="term">~~appendValue~~</var> violates the rules for XML Element content (that is, it contains an invalid character).		<li>The <var class="term">appendedValue</var> argument violates the rules for XML Element content (that is, it contains an invalid character).
	<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 19:		Line 19:
	<li>If a <var>Stringlist</var> object, the value of the target node is set to its current value followed by the <var>Stringlist</var> items converted from EBCDIC to <var>Unicode</var>, with <var>Unicode</var> linefeed characters between the <var>Stringlist</var> items.		<li>If a <var>Stringlist</var> object, the value of the target node is set to its current value followed by the <var>Stringlist</var> items converted from EBCDIC to <var>Unicode</var>, with <var>Unicode</var> linefeed characters between the <var>Stringlist</var> items.
	</ul>		</ul>
	<li><var>AppendValue</var> is available in <var class="product">[[Sirius Mods~~\|"Sirius Mods"~~]]</var> Version 7.6 and later.		<li><var>AppendValue</var> is available in <var class="product">[[Sirius Mods]]</var> Version 7.6 and later.
	</ul>		</ul>

Line 34:		Line 34:
	</p>		</p>
	The result is:		The result is:
	<p class="output"><a>begin value_some more_and more&#xA;and that's all</a>		<p class="output"><a>begin value_some more_and more&amp;#xA;and that's all</a>
	</p></ol>		</p></ol>

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

2011-05-07T02:23:38Z

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

New page

{{Template:XmlNode:AppendValue subtitle}}
<var>AppendValue</var> appends a <var>Unicode</var> string or a <var>Stringlist</var> object to an <var>XmlNode</var> value.

==Syntax==
{{Template:XmlNode:AppendValue syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>nod</th>
<td>An <var>XmlNode</var> that is not the <var>Root</var> node. If it is an <var>Element</var> node, it may have at most one child, and any such child must be a <var>Text</var> node.</td></tr>
<tr><th>appendedValue</th>
<td>A <var>Unicode</var> string or a <var>Stringlist</var> object.</td></tr>
</table>

==Usage notes==
<ul>
<li>The method argument must be a <var>Unicode</var> string or a <var>Stringlist</var> object:
<ul>
<li>If a <var>Unicode</var> string, the value of the target node is set to its current value followed by the <var>Unicode</var> string.
<li>If a <var>Stringlist</var> object, the value of the target node is set to its current value followed by the <var>Stringlist</var> items converted from EBCDIC to <var>Unicode</var>, with <var>Unicode</var> linefeed characters between the <var>Stringlist</var> items.
</ul>
<li><var>AppendValue</var> is available in <var class="product">[[Sirius Mods|"Sirius Mods"]]</var> Version 7.6 and later.
</ul>

==Example==
<ol><li>The following fragment appends a <var>Unicode</var> string and then a <var>Stringlist</var> to an <var>Element</var> value:
<p class="code">%n = %x:[[AddElement_(XmlDoc/XmlNode_function)|addElement]]('a', 'begin value')
%n:appendValue('_some more_')
[[Text_and_Html_statements#The_HTML_or_TEXT_statement|text to]] %sl
and more
and that's all
end text
%n:appendValue(%sl)
%n:print
</p>
The result is:
<p class="output"><a>begin value_some more_and more&#xA;and that's all</a>
</p></ol>

==Request-Cancellation Errors==
<ul>
<li><var class="term">nod</var> does not point to an <var>XmlNode</var>.
<li><var class="term">nod</var> points to the <var>Root</var> node.
<li><var class="term">nod</var> points to an <var>Element</var> node that has more than one child, or that has one, non-<var>Text</var> node child.
<li><var class="term">appendValue</var> violates the rules for XML Element content (that is, it contains an invalid character).
<li>Insufficient free space exists in CCATEMP.
</ul>

==See also==
<ul>
<li><var>[[AddText (XmlNode function)|AddText]]</var> also adds a string to and after a <var>Text</var> node, but only if the <var>[[AdjacentText (XmlDoc property)|AdjacentText]]</var> property is set to <code>Combine</code>.
</ul>
{{Template:XmlNode:AppendValue footer}}

Dme: /* Example */

2011-02-07T18:10:51Z

Example

← Older revision		Revision as of 18:10, 7 February 2011
Line 33:		Line 33:
	<var>Stringlist</var> to an Element value:		<var>Stringlist</var> to an Element value:
	<p class="code">%n = %x:AddElement('a', 'begin value')		<p class="code">%n = %x:AddElement('a', 'begin value')
	%n:~~<var>~~AppendValue~~</var>~~('_some more_')		%n:AppendValue('_some more_')
	Text To %sl		Text To %sl
	and more		and more
	and that's all		and that's all
	~~</p>~~
	End Text		End Text
	%n:~~<var>~~AppendValue~~</var>~~(%sl)		%n:AppendValue(%sl)
	%n:Print		%n:Print
	</p>		</p>

Wiccan: 1 revision

2011-02-07T17:36:55Z

1 revision

← Older revision	Revision as of 17:36, 7 February 2011
(No difference)

Wiccan: 1 revision

2011-02-07T17:36:54Z

1 revision

← Older revision		Revision as of 17:36, 7 February 2011
Line 35:		Line 35:
	%n:<var>AppendValue</var>('_some more_')		%n:<var>AppendValue</var>('_some more_')
	Text To %sl		Text To %sl
	~~<p class="code">~~and more		and more
	and that's all		and that's all
	</p>		</p>
	End Text		End Text