System Function UCS - Revision history

WikiSysop at 20:29, 18 July 2019

2019-07-18T20:29:56Z

← Older revision		Revision as of 16:29, 18 July 2019
Line 1:		Line 1:
	<h2>Universal Character Set - ⎕UCS (System Function) ~~- available in '''monadic''' form only,<br>but with TWO different types of argument calls~~:</h2>		<h2>Universal Character Set - ⎕UCS (System Function):</h2>

	==Monadic Function==		==Monadic Function==
	~~{{BoxStart\|<apll>Z←⎕UCS R</apll>~~
	~~\|Universal Character Set.     <apll>R</apll> should be a '''character string OR set of integers''' to enumerate.}}~~
	~~{{BoxLine\|<apll>R</apll> is  1) a '''character scalar or character String''' OR   2) '''scalar integer or set of Integers'''     to <u>''enumerate''</u>.}}~~
	~~{{BoxEnd\|<apll>Z</apll> is a scalar or vector of results(integer or string, '''inverse of call'''.}}~~

	<p>~~Examples, working with '''⎕UCS~~:~~'''~~</p>		{{BoxStart\|<apll>Z←⎕UCS R</apll>\|}}
	<pre>		{{BoxLine\|<apll>R</apll> is a Character or Integer array to convert.}}
	⎕UCS 'ABC' ~~⍝Type~~ 1(CHAR string) - Locate index positions for letters A, B and C in the Universal Character Set.		{{BoxEnd\|<apll>Z</apll> is an array of results (Integer or Character, reverse of the array storage type of <apll>R</apll>).}}
	65 66 67 ~~⍝Letters~~ A, B and C FOUND at index positions 65, 66 and 67 in ⎕UCS.
	⍴⎕UCS 'ABC' ~~⍝Determine~~ the shape of the result of the call to UCS.		<p>For example:</p>
			<apll><pre>
			⎕UCS 'ABC' ⍝ Type 1(CHAR string) - Locate index positions for letters A, B and C in the Universal Character Set.
			65 66 67 ⍝ Letters A, B and C FOUND at index positions 65, 66 and 67 in ⎕UCS.
			⍴⎕UCS 'ABC' ⍝ Determine the shape of the result of the call to UCS.
	3		3

	⎕AV⍳'ABC' ~~⍝Comparable~~ call to ⎕AV using Iota, but the same letters('ABC').		⎕AV⍳'ABC' ⍝ Comparable call to ⎕AV using Iota, but the same letters('ABC').
	66 67 68 ⍝>> 66 67 68 << using ⎕AV versus >> 65 66 67 << using ⎕UCS - similar, but NOT identical results.		66 67 68 ⍝ >> 66 67 68 << using ⎕AV versus >> 65 66 67 << using ⎕UCS - similar, but NOT identical results.

	⎕UCS 65 66 67 68 69 ~~⍝Type~~ 2(INTEGERS vector) - Find characters associated with integer positions in Universal Character Set.		⎕UCS 65 66 67 68 69 ⍝ Type 2(INTEGERS vector) - Find characters associated with integer positions in Universal Character Set.
	ABCDE ~~⍝Letters~~ A, B, C, D and E 'ABCDE' returned, as a string.		ABCDE ⍝ Letters A, B, C, D and E 'ABCDE' returned, as a string.
	⍴⎕UCS 65 66 67 68 69 ~~⍝Determine~~ the shape of the result.		⍴⎕UCS 65 66 67 68 69 ⍝ Determine the shape of the result.
	5		5

	⎕UCS "012345⍴⍳6789" ~~⍝Another~~ character string - with digits, rho(⍴) and iota(⍳) - also enumerated.		⎕UCS "012345⍴⍳6789" ⍝ Another character string - with digits, rho(⍴) and iota(⍳) - also enumerated.
	48 49 50 51 52 53 9076 9075 54 55 56 57 ~~⍝Note~~ how Rho and Iota are much higher in the UCS than letters and digit-characters.		48 49 50 51 52 53 9076 9075 54 55 56 57 ⍝ Note how Rho and Iota are much higher in the UCS than letters and digit-characters.
	</pre>		</pre></apll>
	<br>		<br>

			==Dyadic Function==

			{{BoxStart\|<apll>Z←L ⎕UCS R</apll>\|}}
			{{BoxLine\|<apll>L</apll> is a character vector <apll>'UTF-8'</apll>, <apll>'UTF-16'</apll> or <apll>'UTF-32'</apll>}}
			{{BoxLine\|<apll>R</apll> is a Character or Integer scalar or vector to convert.}}
			{{BoxEnd\|<apll>Z</apll> is a scalar or vector of results (Integer or Character, reverse of the array storage type of <apll>R</apll>).}}

			<p>According to [https://en.wikipedia.org/wiki/UTF-8 Wikipedia] "UTF-8 is a variable width character encoding capable of encoding all 1,112,064 valid code points in Unicode using one to four 8-bit bytes".</p>

			<p>For example:</p>
			<apll><pre>
			'UTF-8' ⎕UCS '⎕IO'
			226 142 149 73 79
			</pre></apll>

			where <apll>226 142 149</apll> is the <apll>UTF-8</apll> three-byte encoding of <apll>'⎕'</apll> and <apll>73 79</apll> are the one-byte each encoding of <apll>'I'</apll> and <apll>'O'</apll>.

			<p>Correspondingly, a numeric right argument supplies the inverse function as in</p>

			<apll><pre>
			'UTF-8' ⎕UCS 226 142 149 73 79
			⎕IO
			</pre></apll>

			<p>Because NARS2000 does not as yet support either <apll>UTF-16</apll> nor <apll>UTF-32</apll>, those left arguments to <apll>⎕UCS</apll> pass the right argument through to the result, filtering out numbers too large for the corresponding format.</p>

	See also: [[System_Function_AV\|⎕AV]]		See also: [[System_Function_AV\|⎕AV]]

	{{System Variables}}		{{System Variables}}

Robert Wallick: minor punctuation

2015-02-12T01:06:39Z

minor punctuation

← Older revision		Revision as of 21:06, 11 February 2015
Line 13:		Line 13:
	3		3

	⎕AV⍳"ABC" ⍝Comparable call to ⎕AV using Iota, but the same letters("ABC").		⎕AV⍳'ABC' ⍝Comparable call to ⎕AV using Iota, but the same letters('ABC').
	66 67 68 ⍝>> 66 67 68 << using ⎕AV versus >> 65 66 67 << using ⎕UCS - similar, but NOT identical results.		66 67 68 ⍝>> 66 67 68 << using ⎕AV versus >> 65 66 67 << using ⎕UCS - similar, but NOT identical results.

Robert Wallick: Created Quad UCS page, definition

2015-02-12T01:02:34Z

Created Quad UCS page, definition

New page

<h2>Universal Character Set - ⎕UCS (System Function) - available in '''monadic''' form only,<br>but with TWO different types of argument calls:</h2>
==Monadic Function==
{{BoxStart|<apll>Z←⎕UCS R</apll>
|Universal Character Set.     <apll>R</apll> should be a '''character string OR set of integers''' to enumerate.}}
{{BoxLine|<apll>R</apll> is  1) a '''character scalar or character String''' OR   2) '''scalar integer or set of Integers'''     to <u>''enumerate''</u>.}}
{{BoxEnd|<apll>Z</apll> is a scalar or vector of results(integer or string, '''inverse of call'''.}}

<p>Examples, working with '''⎕UCS:'''</p>
<pre>
⎕UCS 'ABC' ⍝Type 1(CHAR string) - Locate index positions for letters A, B and C in the Universal Character Set.
65 66 67 ⍝Letters A, B and C FOUND at index positions 65, 66 and 67 in ⎕UCS.
⍴⎕UCS 'ABC' ⍝Determine the shape of the result of the call to UCS.
3

⎕AV⍳"ABC" ⍝Comparable call to ⎕AV using Iota, but the same letters("ABC").
66 67 68 ⍝>> 66 67 68 << using ⎕AV versus >> 65 66 67 << using ⎕UCS - similar, but NOT identical results.

⎕UCS 65 66 67 68 69 ⍝Type 2(INTEGERS vector) - Find characters associated with integer positions in Universal Character Set.
ABCDE ⍝Letters A, B, C, D and E 'ABCDE' returned, as a string.
⍴⎕UCS 65 66 67 68 69 ⍝Determine the shape of the result.
5

⎕UCS "012345⍴⍳6789" ⍝Another character string - with digits, rho(⍴) and iota(⍳) - also enumerated.
48 49 50 51 52 53 9076 9075 54 55 56 57 ⍝Note how Rho and Iota are much higher in the UCS than letters and digit-characters.
</pre>
<br>
See also: [[System_Function_AV|⎕AV]]

{{System Variables}}