System Function SI

From NARS2000
Revision as of 15:03, 4 June 2017 by WikiSysop (talk | contribs) (Created page with "<h1><apl>⎕SI</apl> - State Indicator</h1> <apll>⎕SI</apll> is a niladic system function which returns a character matrix of the functions and their line numbers currently...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

⎕SI - State Indicator

⎕SI is a niladic system function which returns a character matrix of the functions and their line numbers currently being executed. Consider the following functions:

    ∇ test1
[1]   'Inside test1'
[2]   'SI=' ⎕SI
[3]   
[4]   +
    ∇

    ∇ test2
[1]   'Inside test2, calling test1'
[2]   'SI=' ⎕SI
[3]   test1
    ∇

Calling test1 produces the following output:

      test1
Inside test1
 SI=  test1[2]   
SYNTAX ERROR
test1[4] +
         ∧
      ⎕SI
test1[4] *

In this example, ⎕SI is displayed on test1[2], after which the function is suspended on test1[4] as indicated by the trailing asterisk.

Calling test2 with test1 still suspended produces the following output:

      test2
Inside test2, calling test1
 SI=  test2[2]   
      test1[4] * 
Inside test1
 SI=  test1[2]   
      test2[3]   
      test1[4] * 
SYNTAX ERROR
test1[4] +
         ∧
      ⎕SI
test1[4] *
test2[3]  
test1[4] *

In this example, ⎕SI is displayed on test2[2], and test1 is called on test2[3]. In turn, test1 calls ⎕SI on test1[2] and suspends on test1[4], all of which is reflected in the output of ⎕SI at each level.

Special Rows In ⎕SI

Note that a row in the result of ⎕SI might represent Quad input, the Execute function, and/or a Magic Function. These rows are identified by a leading , , and #, respectively. After these rows are removed from ⎕SI, the remaining rows match up one-to-one with the elements of ⎕LC.


Note: SI is a niladic 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 DT ELX FC FEATURE FPC IC IO
LR 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 DFT 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 (except for the ⎕A family of functions) are case insensitive


See Also
System Commands System Variables and Functions Operators


Keyboard
Alt+Shift
Alt ¨ ¯ < > × ÷
Shift ~ ! @ # $ % ^ & * ( ) _ +
Key ` 1 2 3 4 5 6 7 8 9 0 - =
Alt+Shift
Alt ? § π
Shift Q W E R T Y U I O P { } |
Key q w e r t y u i o p [ ] \
Alt+Shift
Alt
Shift A S D F G H J K L : "
Key a s d f g h j k l ; '
Alt+Shift χ
Alt
Shift Z X C V B N M < > ?
Key z x c v b n m , . /
NARS 2000 Lang
Tool
Bar
+ - × ÷ * ! ? |
< = >
~ § π .. ,
/ \ ¨ .
_ ¯
Second Row i j k i j k l g p r v x