U (String function) - Revision history

Dme: /* Examples */

2016-06-03T07:40:59Z

Examples

← Older revision		Revision as of 07:40, 3 June 2016
Line 62:		Line 62:
	<p>		<p>
	An alternative bracket substitution is to use <var>[[Using variables and values in computation#Declare statements for %variables\|Static]]</var> %variables initialized to the correct values, for example: </p>		An alternative bracket substitution is to use <var>[[Using variables and values in computation#Declare statements for %variables\|Static]]</var> %variables initialized to the correct values, for example: </p>
	<p class="code">%lsq is string len 1 static initial('['):u		<p class="code">%lsq is string len 1 static initial('&#x5b;'):u
	%rsq is string len 1 static initial(']'):u </p>		%rsq is string len 1 static initial('&#x5d;'):u </p>
	<p>		<p>
	But this approach requires declaring a pair of variables (within the scope of the method/subroutine), and it performs a run-time execution of two concatenations as well as conversion from EBCDIC to Unicode. </p>		But this approach requires declaring a pair of variables (within the scope of the method/subroutine), and it performs a run-time execution of two concatenations as well as conversion from EBCDIC to Unicode. </p>

JAL: /* Examples */ add an anchor ID

2016-05-19T17:58:15Z

Examples: add an anchor ID

← Older revision		Revision as of 17:58, 19 May 2016
Line 49:		Line 49:
	<p class="note"><b>Note:</b> Simply specifying <code>print %tm</code> in this example would produce an attempt to convert the Unicode character to EBCDIC for printing, but since the Unicode trademark character does not translate to a valid EBCDIC character, the <var>Print</var> output would be the character reference for the trademark: <code>&#x2122;</code>.</p></li>		<p class="note"><b>Note:</b> Simply specifying <code>print %tm</code> in this example would produce an attempt to convert the Unicode character to EBCDIC for printing, but since the Unicode trademark character does not translate to a valid EBCDIC character, the <var>Print</var> output would be the character reference for the trademark: <code>&#x2122;</code>.</p></li>

	<li>Say you want to use the following [[XPath]] expression within a [[Janus SOAP]] method:		<li id="brackets">Say you want to use the following [[XPath]] expression within a [[Janus SOAP]] method:

	<p class="code"><nowiki>*/pers[@name="Rebecca"]</nowiki></p>		<p class="code"><nowiki>*/pers[@name="Rebecca"]</nowiki></p>

JAL: /* Examples */ add link

2016-05-18T00:34:00Z

Examples: add link

← Older revision		Revision as of 00:34, 18 May 2016
Line 66:		Line 66:
	<p>		<p>
	But this approach requires declaring a pair of variables (within the scope of the method/subroutine), and it performs a run-time execution of two concatenations as well as conversion from EBCDIC to Unicode. </p>		But this approach requires declaring a pair of variables (within the scope of the method/subroutine), and it performs a run-time execution of two concatenations as well as conversion from EBCDIC to Unicode. </p>
	</li></ol>		<p>
			For more information about square bracket translations, see [[Unicode#sqbrackets\|this short summary]]. </p></li></ol>

	==See also==		==See also==

JAL: add example of square bracket substitution

2016-05-18T00:14:05Z

add example of square bracket substitution

@@ Line 44: / Line 44: @@
 </p><li>The following <var>Print</var> statement displays <code>2122</code>:
 <p class="code">%tm Unicode Initial('&amp;#x2122;':U)
-print %tm:UnicodeToUtf16:[[StringToHex (String_function)|StringToHex]]
+print %tm:UnicodeToUtf16:[[StringToHex (String function)|StringToHex]]
 </p>
-Simply specifying <code>print %tm</code> in the previous example above would attempt to convert to EBCDIC, but since the Unicode trademark character does not translate to a valid EBCDIC character, the <var>Print</var> output will use a character reference: <code>&amp;#x2122;</code>.</ol>
+<p class="note"><b>Note:</b> Simply specifying <code>print %tm</code> in this example would produce an attempt to convert the Unicode character to EBCDIC for printing, but since the Unicode trademark character does not translate to a valid EBCDIC character, the <var>Print</var> output would be the character reference for the trademark: <code>&amp;#x2122;</code>.</p></li>
 ==See also==

JAL: /* Syntax terms */

2012-11-06T19:33:49Z

Syntax terms

← Older revision		Revision as of 19:33, 6 November 2012
Line 14:		Line 14:
	<td>A constant character string value, which may include an XML-style hexadecimal character reference or an XHTML entity reference. That is, <var class="term">string</var> may contain an ampersand (<tt>&</tt>) in the following cases:		<td>A constant character string value, which may include an XML-style hexadecimal character reference or an XHTML entity reference. That is, <var class="term">string</var> may contain an ampersand (<tt>&</tt>) in the following cases:
	<ul>		<ul>
	<li>At the start of the substring <code>&</code>. This substring is converted to a single ampersand (<code>&</code>) character.		<li>At the start of the substring <code>&amp;</code>. This substring is converted to a single ampersand (<code>&</code>) character.

	<li>At the start of a hexadecimal character reference: for example, the eight characters <code>&#x201C;</code> for the Unicode "Left double quotation mark" (<tt>“</tt>). The character reference is converted to the referenced character.		<li>At the start of a hexadecimal character reference: for example, the eight characters <code>&#x201C;</code> for the Unicode "Left double quotation mark" (<tt>“</tt>). The character reference is converted to the referenced character.

JALWiccan: 1 revision

2012-11-06T18:22:50Z

1 revision

← Older revision	Revision as of 18:22, 6 November 2012
(No difference)

JAL at 18:22, 6 November 2012

2012-11-06T18:22:37Z

← Older revision		Revision as of 18:22, 6 November 2012
Line 14:		Line 14:
	<td>A constant character string value, which may include an XML-style hexadecimal character reference or an XHTML entity reference. That is, <var class="term">string</var> may contain an ampersand (<tt>&</tt>) in the following cases:		<td>A constant character string value, which may include an XML-style hexadecimal character reference or an XHTML entity reference. That is, <var class="term">string</var> may contain an ampersand (<tt>&</tt>) in the following cases:
	<ul>		<ul>
	<li>At the start of the substring <code>&~~amp;amp;~~</code>. This substring is converted to a single ampersand (<code>&</code>) character.		<li>At the start of the substring <code>&</code>. This substring is converted to a single ampersand (<code>&</code>) character.

	<li>At the start of a hexadecimal character reference: for example, the eight characters <code>&#x201C;</code> for the Unicode "Left double quotation mark" (<tt>“</tt>). The character reference is converted to the referenced character.		<li>At the start of a hexadecimal character reference: for example, the eight characters <code>&#x201C;</code> for the Unicode "Left double quotation mark" (<tt>“</tt>). The character reference is converted to the referenced character.

JAL at 22:46, 5 November 2012

2012-11-05T22:46:19Z

← Older revision		Revision as of 22:46, 5 November 2012
Line 5:		Line 5:
	==Syntax==		==Syntax==
	{{Template:String:U syntax}}		{{Template:String:U syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%unicode</th>		<tr><th>%unicode</th>
	<td>A <var>Unicode</var> variable to receive the Unicode string represented by the method object <var class="term">string</var>.</td></tr>		<td>A <var>Unicode</var> variable to receive the Unicode string represented by the method object <var class="term">string</var>.</td></tr>

	<tr><th>string</th>		<tr><th>string</th>
	<td>A constant character string value, which may include an XML-style hexadecimal character reference or an XHTML entity reference. That is, <var class="term">string</var> may contain an ampersand (<~~code~~>&</~~code~~>) in the following cases:<ul>		<td>A constant character string value, which may include an XML-style hexadecimal character reference or an XHTML entity reference. That is, <var class="term">string</var> may contain an ampersand (<tt>&</tt>) in the following cases:
			<ul>
	<li>At the start of the substring <code>&amp;</code>. This substring is converted to a single ampersand (<code>&</code>) character.		<li>At the start of the substring <code>&amp;</code>. This substring is converted to a single ampersand (<code>&</code>) character.
	<li>At the start of a hexadecimal character reference: for example, the eight characters <code>&#x201C;</code> for the Unicode "Left double quotation mark" (<~~code~~>“</~~code~~>). The character reference is converted to the referenced character.<li>As of <var class=product>Sirius Mods</var> Version 7.6, an XHTML entity reference (for example, the six characters <code>&nbsp;</code> for the "non-breaking-space" character). The entity reference is converted to the referenced character.
			<li>At the start of a hexadecimal character reference: for example, the eight characters <code>&#x201C;</code> for the Unicode "Left double quotation mark" (<tt>“</tt>). The character reference is converted to the referenced character.

			<li>As of <var class=product>Sirius Mods</var> Version 7.6, an XHTML entity reference (for example, the six characters <code>&nbsp;</code> for the "non-breaking-space" character). The entity reference is converted to the referenced character.
	</ul>		</ul>

Line 21:		Line 27:
	<ul>		<ul>
	<li><var>U</var> is a compile-time-only equivalent of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> method of the intrinsic <var>[[String class\|string]]</var> class (with its <var>CharacterDecode</var> argument implicitly set to <code>True</code>).		<li><var>U</var> is a compile-time-only equivalent of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> method of the intrinsic <var>[[String class\|string]]</var> class (with its <var>CharacterDecode</var> argument implicitly set to <code>True</code>).

	<li>Using the <var>U</var> method (or <var>EbcdicToUnicode</var>) is necessary for converting to type <var>Unicode</var> if the string you want to convert may contain a hexadecimal character reference. Such a reference cannot be meaningfully assigned to a <var>Unicode</var> variable otherwise, whereas keyboard-available characters can simply be assigned directly to a <var>Unicode</var> variable without character reference and without conversion by <var>U</var>.		<li>Using the <var>U</var> method (or <var>EbcdicToUnicode</var>) is necessary for converting to type <var>Unicode</var> if the string you want to convert may contain a hexadecimal character reference. Such a reference cannot be meaningfully assigned to a <var>Unicode</var> variable otherwise, whereas keyboard-available characters can simply be assigned directly to a <var>Unicode</var> variable without character reference and without conversion by <var>U</var>.
	<li>The <var>U</var> method is available as of <var class="product">[[Sirius Mods~~\|Sirius Mods]]~~</var> Version 7.3.</ul>
			<li>The <var>U</var> method is available as of <var class="product">Sirius Mods</var> Version 7.3.</ul>

	==Examples==		==Examples==
	<ol><li>The following <var>Print</var> statement displays a plus sign (<code>+</code>):		<ol>
			<li>The following <var>Print</var> statement displays a plus sign (<code>+</code>):
	<p class="code">%p Unicode Initial('+')		<p class="code">%p Unicode Initial('+')
	print %p		print %p
	</p>		</p>

	<li>The following <var>Print</var> statement displays a copyright sign (<code>©</code>):		<li>The following <var>Print</var> statement displays a copyright sign (<code>©</code>):
	<p class="code">%copy Unicode Initial('&copy;':U)		<p class="code">%copy Unicode Initial('&copy;':U)

JAL2: /* Examples */

2012-03-09T20:54:10Z

Examples

← Older revision		Revision as of 20:54, 9 March 2012
Line 33:		Line 33:
	print %copy		print %copy
	</p><li>The following <var>Print</var> statement displays <code>2122</code>:		</p><li>The following <var>Print</var> statement displays <code>2122</code>:
	<p class="code">%tm Unicode Initial('™':U)		<p class="code">%tm Unicode Initial('&#x2122;':U)
	print %tm:UnicodeToUtf16:[[StringToHex (String_function)\|StringToHex]]		print %tm:UnicodeToUtf16:[[StringToHex (String_function)\|StringToHex]]
	</p>		</p>

JAL2: /* Examples */

2012-03-09T20:51:55Z

Examples

← Older revision		Revision as of 20:51, 9 March 2012
Line 30:		Line 30:
	</p>		</p>
	<li>The following <var>Print</var> statement displays a copyright sign (<code>©</code>):		<li>The following <var>Print</var> statement displays a copyright sign (<code>©</code>):
	<p class="code">%copy Unicode Initial('&~~amp;~~amp;copy;':U)		<p class="code">%copy Unicode Initial('&copy;':U)
	print %copy		print %copy
	</p><li>The following <var>Print</var> statement displays <code>2122</code>:		</p><li>The following <var>Print</var> statement displays <code>2122</code>: