System Function NL

From NARS2000
Jump to: navigation, search

Quad Name List - ⎕NL     (System Function)

Monadic Function

Z←⎕NL R returns a character matrix of user function names and or variable names where R = 3 (function names) and or 2 (variable names).
R is either 2 (variable names) or 3 (function names) or 2 3 (both function and variable names).
Z is a character matrix of user objects in the workspace, each row being a name in the workspace.


Quad Names List sample monadic calls:

      ⎕NL 3     ⍝ list function names in the active workspace
      ⎕NL 2     ⍝ list variable names in the active workspace
      ⎕NL 3 2   ⍝ list function AND variable names in the active workspace
      ⍴⎕NL 3    ⍝ The shape of names list - 1st element returned(# rows) shows the "user Function Count" in the active workspace

List all APL Quad System Variables (per APL Standard):

      ⎕NL 5
⎕alx    
⎕ct     
⎕dm     
⎕dt     
⎕elx    
⎕fc     
⎕feature
⎕fpc    
⎕ic     
⎕io     
⎕lx     
⎕pp     
⎕pr     
⎕pw     
⎕rl     
⎕sa     
⎕wsid   

List all APL Quad System Functions (per APL Standard):

      ⎕NL 6
⎕a       
⎕at      
⎕av      
⎕cr      
⎕d       
⎕dl      
⎕dr      
⎕ea      
⎕ec      
⎕em      
⎕error   
⎕es      
⎕et      
⎕ex      
⎕fmt     
⎕fx      
⎕lc      
⎕mf      
⎕nappend 
⎕nc      
⎕ncreate 
⎕nerase  
⎕nl      
⎕nlock   
⎕nnames  
⎕nnums   
⎕nread   
⎕nrename 
⎕nreplace
⎕nresize 
⎕nsize   
⎕ntie    
⎕nuntie  
⎕sysid   
⎕sysver  
⎕t       
⎕tc      
⎕tcbel   
⎕tcbs    
⎕tcesc   
⎕tcff    
⎕tcht    
⎕tclf    
⎕tcnl    
⎕tcnul   
⎕tf      
⎕ts      
⎕ucs     
⎕vr      
⎕wa     

NARS has added additional features over and beyond APL's standard ⎕NL. Magic Functions are in some ways for advanced APL programmers and or NARS developers - or anyone with a great idea to improve APL's functionality, see NARS Discussion Board on topics such as New Primitive Operators. To see all magic functions available in NARS use the following:

      ⎕NL 23 24     ⍝ list all Magic Functions and Operators
#BoxFMT         
#Conform        
#DydConv        
#DydDnShoe      
#DydDomino      
#DydDotDot      
#DydEpsUnderbar 
#DydIota        
#DydIotaUnderbar
#DydLRShoeUnd   
#DydRank        
#DydScan        
#DydScan1       
#DydUpShoe      
#IdnConv        
#IdnDot         
#IdnJotDot      
#MAD            
#MDIU           
#MEO            
#MI             
#MIO            
#MLRS           
#MLRSU          
#MM             
#MMUL           
#MonDnShoe      
#MonDomino      
#MonDot         
#MonDotAll      
#MonDotCr       
#MonDotMf       
#MonDotPerm     
#MonFMT         
#MonIota        
#MonRank        
#MonVR          
#MSD            
#MU             
#RoS2           
#RoS1L          
#RoS1R          
#SD             
      ⎕NL 23
#BoxFMT         
#Conform        
#DydDnShoe      
#DydDomino      
#DydDotDot      
#DydEpsUnderbar 
#DydIota        
#DydIotaUnderbar
#DydLRShoeUnd   
#DydUpShoe      
#IdnDot         
#MAD            
#MDIU           
#MEO            
#MI             
#MIO            
#MLRS           
#MLRSU          
#MM             
#MMUL           
#MonDnShoe      
#MonDomino      
#MonDotAll      
#MonDotMf       
#MonDotPerm     
#MonFMT         
#MonIota        
#MonVR          
#MSD            
#MU             
#SD             
      ⎕NL 24
#DydConv  
#DydRank  
#DydScan  
#DydScan1 
#IdnConv  
#IdnJotDot
#MonDot   
#MonDotCr 
#MonRank  
#RoS2     
#RoS1L    
#RoS1R    

Most magic functions are transparent to you the APL user since they implement APL symbol functionality; however, they enhance APL's functionality, ref. ⎕FMT.


Dyadic Function

Z←L ⎕NL R returns a character matrix of user function names and or variable names where R = 3 (function names) and or 2 (variable names)..
R is either 2 (var names) or 3 (fns names) or 2 3 (both fns and vars).
L is a letter or letters for LIMITING fns/var names list, i.e. which BEGIN with the letter(s) to show.


Quad Names List sample dyadic calls:

      "A" ⎕NL 3     ⍝ List all function names beginning with A.
      "M" ⎕NL 2     ⍝ List all variable names beginning with M.
      "AC" ⎕NL 3 2  ⍝ List all function AND variable names beginning with letter "A" and also letter "C".

Function ⎕NL may be used inside user functions whereas system commands )FNS and )VARS cannot be used inside a user function.

See Also: Quad Name Classif. ⎕NC


Note: ⎕NL is available as both a monadic and dyadic form system function, you cannot assign a value to it.

System Variables (A value may be assigned to these except for ⎕DM)
ALX CT DM DQ DT ELX FC FEATURE FPC IC
IO LX PP PR PW RL SA WSID
Niladic System Functions (a value cannot be assigned to these)
A AV EM ET LC NNAMES NNUMS SI SYSID SYSVER
T TC TCBEL TCBS TCESC TCFF TCHT TCLF TCNL TCNUL
TS WA
Monadic or dyadic system functions (a value cannot be assigned to these)
AT CR DC DL DR EA EC ERROR ES EX
FMT FX MF NAPPEND NC NCREATE NERASE NINFO NL NLOCK
NREAD NRENAME NREPLACE NRESIZE NSIZE NTIE NUNTIE STOP TF TRACE
UCS VR
Note that quad functions and variables are case insensitive