System Function NC - Revision history

WikiSysop at 00:47, 10 March 2019

2019-03-10T00:47:42Z

← Older revision		Revision as of 20:47, 9 March 2019
Line 56:		Line 56:
	</pre>		</pre>
	<font color=green><strong>		<font color=green><strong>
	⎕NC can be used to determine the presence(=2) or absence(=0) of an optional braced argument e.g. {L arg} FuncName R     argument in a user function call through ⎕NC usage WITHIN the user function itself, e.g. ⎕NC 'ArgName' !</strong></font> Ref. [[User-Defined_Functions/Operators\|User Defined Functions.]]		⎕NC can be used to determine the presence(=2) or absence(=0) of an optional braced argument e.g. {L arg} FuncName R     argument in a user function call through ⎕NC usage WITHIN the user function itself, e.g. ⎕NC 'ArgName' !</strong></font> Ref. [[User-Defined_Functions/Operators/Hyperators\|User Defined Functions/Operators/Hyperators.]]
	<br>		<br>
	See also: [[System_Function_NL\|Quad Name List ⎕NL]]		See also: [[System_Function_NL\|Quad Name List ⎕NL]]

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

WikiSysop at 00:06, 10 March 2019

2019-03-10T00:06:16Z

← Older revision		Revision as of 20:06, 9 March 2019
Line 3:		Line 3:
	{{BoxStart\|<apll>Z←⎕NC R</apll>		{{BoxStart\|<apll>Z←⎕NC R</apll>
	\|⎕Name Classification.     Argument <apll>R</apll> should be a '''string, vector or matrix''' of workspace names to show names classes for.}}		\|⎕Name Classification.     Argument <apll>R</apll> should be a '''string, vector or matrix''' of workspace names to show names classes for.}}
	{{BoxLine\|<apll>R</apll> is ~~ ~~ a ~~'''~~character Scalar, Vector or ~~character string~~ Matrix~~'''   - to <u>''enumerate'' name classes for</u>.~~}}		{{BoxLine\|<apll>R</apll> is a character Scalar, Vector or Matrix of Names}}
	{{BoxEnd\|<apll>Z</apll> ~~(returned)~~ is a scalar or vector of name ~~class results - e.g. a scalar or vector of integers.~~}}		{{BoxEnd\|<apll>Z</apll> is a integer scalar or vector of name classes}}
	~~<br>~~
	System function ⎕NC takes as its right argument a character string specifying a name, vector of names, or character matrix of names. It returns a numeric result which is the classification of each name:~~<br>~~		System function ⎕NC takes as its right argument a character string specifying a name, vector of names, or character matrix of names. It returns a numeric result which is the classification of each name. If called from within a user-defined function/operator/hyperator, ⎕NC returns the name class of the most local instance of the name:
	~~<u>'''Z''' will contain:</u><br>~~		{\| class="wikitable"
	~~'''~~1 = line label~~''' (if ⎕NC called from WITHIN a user function)<br>~~		\|-
	~~'''~~2 = variable~~''' (global~~ variable ~~name class, or if ⎕NC used IN a user~~ function ~~then local variable names class)~~<br>		\| 1\|\|    User line label
	~~'''3 = function''' (for function name(s))~~<br>		\|-
	~~'''4 =~~ operator~~'''<br>~~		\| 2\|\|    User variable
	~~'''~~0 ~~= name~~ not in use~~'''<br>~~		\|-
	~~'''~~¯1 ~~= invalid~~ name~~'''<br>~~		\| 3\|\|    User-defined function
			\|-
			\| 4\|\|    User-defined operator
			\|-
			\| 5\|\|    System variable
			\|-
			\| 6\|\|    System function
			\|-
			\|7-20\|\|    <i>Unused</i>
			\|-
			\|21 \|\|    System label
			\|-
			\|22 \|\|    <i>Unused</i>
			\|-
			\|23 \|\|    Magic function
			\|-
			\|24 \|\|    Magic operator
			\|-
			\|25 \|\|    Magic hyperator
			\|-
			\|26 \|\|    User-defined hyperator
			\|-
			\| 0 \|\|    Name not in use
			\|-
			\|¯1 \|\|    Invalid name
			\|}

	<p>Examples, working with '''⎕NC:'''</p>		<p>Examples, working with '''⎕NC:'''</p>

Robert Wallick: added usage with optional braced left arg in a function call

2015-02-13T23:14:51Z

added usage with optional braced left arg in a function call

← Older revision		Revision as of 19:14, 13 February 2015
Line 30:		Line 30:
	¯1 ¯1 2 0 ⍝Names '⍳ ' and '⍴' are NOT validly constructed(¯1); Variable A IS Found(2), ZZ is validly constructed but Not Found(0).		¯1 ¯1 2 0 ⍝Names '⍳ ' and '⍴' are NOT validly constructed(¯1); Variable A IS Found(2), ZZ is validly constructed but Not Found(0).
	</pre>		</pre>
			<font color=green><strong>
			⎕NC can be used to determine the presence(=2) or absence(=0) of an optional braced argument e.g. {L arg} FuncName R     argument in a user function call through ⎕NC usage WITHIN the user function itself, e.g. ⎕NC 'ArgName' !</strong></font> Ref. [[User-Defined_Functions/Operators\|User Defined Functions.]]
	<br>		<br>
	See also: [[System_Function_NL\|Quad Name List ⎕NL]]		See also: [[System_Function_NL\|Quad Name List ⎕NL]]

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

Robert Wallick: minor wording

2015-02-13T22:28:23Z

minor wording

← Older revision		Revision as of 18:28, 13 February 2015
Line 19:		Line 19:
	)VARS ⍝Show which global variables exists in the current NARS APL workspace		)VARS ⍝Show which global variables exists in the current NARS APL workspace
	A B C ⍝3 global variables names exist - A, B and C		A B C ⍝3 global variables names exist - A, B and C
	⎕NC 3 2⍴'A B C ' ~~⍝Same~~ use of ⎕NC with a MATRIX right argument		⎕NC 3 2⍴'A B C ' ⍝Sample use of ⎕NC with a MATRIX right argument(3 names 'A ', 'B ' and 'C ' to enumerate/check)
	2 2 2 ⍝ 2 = global variable		2 2 2 ⍝ 2 = global variable <--> all 3 names WERE FOUND.
	⎕NC 3 1⍴'ABC' ⍝Matrix right argument, compare to first call to ⎕NC, just above - {3 2⍴} vs {3 1⍴}		⎕NC 3 1⍴'ABC' ⍝Matrix right argument, compare to first call to ⎕NC, just above - {3 2⍴} vs {3 1⍴}
	2 2 2 ⍝Same correct results(2 2 2) = global variable names class		2 2 2 ⍝Same correct results(2 2 2) = global variable names class

Robert Wallick: minor wording

2015-02-13T21:43:55Z

minor wording

← Older revision		Revision as of 17:43, 13 February 2015
Line 2:		Line 2:
	==Monadic Function==		==Monadic Function==
	{{BoxStart\|<apll>Z←⎕NC R</apll>		{{BoxStart\|<apll>Z←⎕NC R</apll>
	\|~~Name~~ Classification.     <apll>R</apll> should be a '''string, vector or matrix''' of workspace names to show names ~~types~~ for.}}		\|⎕Name Classification.     Argument <apll>R</apll> should be a '''string, vector or matrix''' of workspace names to show names classes for.}}
	{{BoxLine\|<apll>R</apll> is   a '''character Scalar, Vector or character string Matrix'''   ~~ ~~ to <u>''enumerate'' name ~~class~~ for</u>.}}		{{BoxLine\|<apll>R</apll> is   a '''character Scalar, Vector or character string Matrix'''   - to <u>''enumerate'' name classes for</u>.}}
	{{BoxEnd\|<apll>Z</apll> (returned) is a scalar or vector of name class results - e.g. a scalar or vector of integers.}}		{{BoxEnd\|<apll>Z</apll> (returned) is a scalar or vector of name class results - e.g. a scalar or vector of integers.}}
	<br>		<br>
Line 28:		Line 28:
	0 ⍝ Name 'ABC' NOT FOUND		0 ⍝ Name 'ABC' NOT FOUND
	⎕NC ⊃'⍳ ' '⍴' 'A' 'ZZ'		⎕NC ⊃'⍳ ' '⍴' 'A' 'ZZ'
	¯1 ¯1 2 0 ⍝Names '⍳ ' and '⍴' are NOT validly constructed; Variable A IS Found(2), ZZ is validly constructed but Not Found(0).		¯1 ¯1 2 0 ⍝Names '⍳ ' and '⍴' are NOT validly constructed(¯1); Variable A IS Found(2), ZZ is validly constructed but Not Found(0).
	</pre>		</pre>
	<br>		<br>

Robert Wallick: Created quad NC page

2015-02-13T21:39:33Z

Created quad NC page

New page

<h2>Name Classification - ⎕NC (System Function) - available in '''monadic''' form only:</h2>
==Monadic Function==
{{BoxStart|<apll>Z←⎕NC R</apll>
|Name Classification.     <apll>R</apll> should be a '''string, vector or matrix''' of workspace names to show names types for.}}
{{BoxLine|<apll>R</apll> is   a '''character Scalar, Vector or character string Matrix'''     to ''enumerate'' name class for.}}
{{BoxEnd|<apll>Z</apll> (returned) is a scalar or vector of name class results - e.g. a scalar or vector of integers.}}
 
System function ⎕NC takes as its right argument a character string specifying a name, vector of names, or character matrix of names. It returns a numeric result which is the classification of each name: 
'''Z''' will contain: 
'''1 = line label''' (if ⎕NC called from WITHIN a user function) 
'''2 = variable''' (global variable name class, or if ⎕NC used IN a user function then local variable names class) 
'''3 = function''' (for function name(s)) 
'''4 = operator''' 
'''0 = name not in use''' 
'''¯1 = invalid name''' 

Examples, working with '''⎕NC:'''
<pre>
)VARS ⍝Show which global variables exists in the current NARS APL workspace
A B C ⍝3 global variables names exist - A, B and C
⎕NC 3 2⍴'A B C ' ⍝Same use of ⎕NC with a MATRIX right argument
2 2 2 ⍝ 2 = global variable
⎕NC 3 1⍴'ABC' ⍝Matrix right argument, compare to first call to ⎕NC, just above - {3 2⍴} vs {3 1⍴}
2 2 2 ⍝Same correct results(2 2 2) = global variable names class
⎕NC ⊃'A ' 'B' 'B' ⍝Call with a disclosed Nested Vector - note the extra space after variable named 'A' >> 'A '
2 2 2
⎕NC ⊃'A' 'B' 'C' ⍝This call FAILS(returns 0=name not in use) because APL sees ⎕NC 'ABC'; there is NO variable named 'ABC'.
0 ⍝ Name 'ABC' NOT FOUND
⎕NC ⊃'⍳ ' '⍴' 'A' 'ZZ'
¯1 ¯1 2 0 ⍝Names '⍳ ' and '⍴' are NOT validly constructed; Variable A IS Found(2), ZZ is validly constructed but Not Found(0).
</pre>
 
See also: [[System_Function_NL|Quad Name List ⎕NL]]

{{System Variables}}