System Variable DM: Difference between revisions

From NARS2000
Jump to navigationJump to search
m See see also for ⎕ELX and ⎕EA
No edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
<h1>{quad}DM - Diagnostic Message</h1>
<h1><aplxx>⎕DM</aplxx> - Diagnostic Message</h1>
{{BoxStart|⎕DM
{{BoxStart|⎕DM
| '''Diagnostic Message set to last error message string APL's Interpreter encountered'''.}}
| Diagnostic Message set to last error message the APL interpreter encountered.}}
{{BoxEnd|⎕DM <u>cannot be assigned a value by the User.</u> '''APL interpreter sets its string value''' when it encounters an error, e.g. 'DOMAIN ERROR'.}}
{{BoxEnd|Unlike other system variables, <apll>⎕DM</apll> cannot be assigned a value by the User.  The APL interpreter sets its value when it encounters an error, e.g. <apll>DOMAIN ERROR</apll>.}}


⎕DM is set by APL to the last diagnostic error message the Interpreter encountered.<br>
 
It is for informational, for diagnostic purposes only.  User cannot set its value.<br>
<apll>⎕DM</apll> is set by APL to the last diagnostic error message the Interpreter encountered. It is for informational and diagnostic purposes only.  User cannot set its value.
'''⎕DM is useful''' for <u>'''viewing'''</u> the last error message, particularly if Error Trapping is<br>
 
being used, or for system-function and user-function '''debugging purposes'''.  Just type in:
<apll>⎕DM</apll> is useful for viewing the last error message, particularly if Error Trapping is being used, or for system-function and user-function debugging purposes.  For example:
<pre>
 
<apll><pre>
       ⎕DM
       ⎕DM
      ⍴⎕DM  ⍝ In a CLEAR APL Workspace ⎕DM's value is an empty character vector
0
      +
SYNTAX ERROR
      +
      ∧
      ⍴⎕←⎕DM
SYNTAX ERROR
      +
      ∧
28</pre></apll>
<apll>⎕DM</apll> is a system variable. An APL error in the '''right argument''' of <apll>⎕EA</apll> will send a diagnostic message to <apll>⎕DM</apll>, as well as a '''triggering error event''' for <apll>⎕ELX</apll>.
See Also: [[System_Variable_ELX|⎕ELX]] and [[System_Function_EA|⎕EA]]




      ⍴⎕DM  ⍝In a CLEAR APL Workspace ⎕DM's value is a null string.
0
</pre>
Quad DM(⎕DM) is a system variable. An APL error in the '''right argument''' of '''⎕EA will''' send a<br>
diagnostic message to ⎕DM, as will a '''triggering error event''' re ⎕ELX.<br><br>
See Also: [[System_Variable_ELX|Quad ELX or ⎕ELX]] and [[System_Function_EA|Quad EA or ⎕EA]]<br>
{{System Variables}}
{{System Variables}}
{{Article footer}}
{{Article footer}}
{{stub}}
{{stub}}

Latest revision as of 13:05, 16 April 2018

⎕DM - Diagnostic Message

⎕DM Diagnostic Message set to last error message the APL interpreter encountered.
Unlike other system variables, ⎕DM cannot be assigned a value by the User. The APL interpreter sets its value when it encounters an error, e.g. DOMAIN ERROR.


⎕DM is set by APL to the last diagnostic error message the Interpreter encountered. It is for informational and diagnostic purposes only. User cannot set its value.

⎕DM is useful for viewing the last error message, particularly if Error Trapping is being used, or for system-function and user-function debugging purposes. For example:

      ⎕DM

      ⍴⎕DM   ⍝ In a CLEAR APL Workspace ⎕DM's value is an empty character vector
0
      +
SYNTAX ERROR
      +
      ∧
      ⍴⎕←⎕DM
SYNTAX ERROR
      +
      ∧
28

⎕DM is a system variable. An APL error in the right argument of ⎕EA will send a diagnostic message to ⎕DM, as well as a triggering error event for ⎕ELX.

See Also: ⎕ELX and ⎕EA


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
A+S ⍪ ≡ ≢ ⍒ ⍋ ⌽ ⍉ ⊖ ⍟ ⍱ ⍲ ⍠ ⌹
Alt ⋄ ¨ ¯ < ≤ ∅ ≥ > ≠ ∨ ∧ × ÷
Sh ~ ! @ # $ % ^ & * ( ) _ +
Key ` 1 2 3 4 5 6 7 8 9 0 - =
A+S ⍷ √ ⍨ ⍸ ⍥ ⍣ ⍞ ⍬ ⊣
Alt ? ⍵ ∊ ⍴ § ↑ ↓ ⍳ ○ π ← → ⊢
Sh Q W E R T Y U I O P { } |
Key q w e r t y u i o p [ ] \
A+S ∫ ∂ ⌻ ⍢ ⍙ ⍤ ⍫ ⌷
Alt ⍺ ⌈ ⌊ ∞ ∇ ∆ ∘ ‼ ⎕ ⍎ ⍕
Sh A S D F G H J K L : "
Key a s d f g h j k l ; '
A+S ⊆ ⊇ χ ⍡ ⍭ ⊙
Alt ⊂ ⊃ ∩ ∪ ⊥ ⊤ ⍦ ⍝ ⍀ ⌿
Sh Z X C V B N M < > ?
Key z x c v b n m , . /
{{#ifeq:{{{1}}}|4||title="match" style="border-width:thick; border-color:blue; background-color:yellow;"|≡ {{#ifeq:{{{1}}}|7||title="iota" style="border-width:thick; border-color:blue; background-color:yellow;" |⍳ {{#ifeq:{{{1}}}|9||title="slash" style="border-width:thick; border-color:blue; background-color:yellow;" |/ {{#ifeq:{{{1}}}|11||title="diamond" style="border-width:thick; border-color:blue; background-color:yellow;" |⋄ {{#switch: {{{1}}}
NARS 2000 Lang
Tool
Bar

{{#ifeq:{{{1}}}|1||title="assign" style="border-width:thick; border-color:blue; background-color:yellow;" |←

→ bgcolor=cyan title="assign" |← → }}

{{#ifeq:{{{1}}}|2||title="plus" style="border-width:thick; border-color:blue; background-color:yellow;" |+

- × ÷ * ⍟ ⌹ ○ ! ? √ bgcolor=cyan title="plus" |+ - × ÷ * ⍟ ⌹ ○ ! ? √ }}

{{#ifeq:{{{1}}}|3||title="mod" style="border-width:thick; border-color:blue; background-color:yellow;" ||

⌈ ⌊ ⊥ ⊤ ⊣ ⊢
⌈ ⌊ ⊥ ⊤ ⊣ ⊢
≢ < ≤ = ≥ > ≠ bgcolor=cyan title="match" |≡ ≢ < ≤ = ≥ > ≠ }}

{{#ifeq:{{{1}}}|5||title="down caret" style="border-width:thick; border-color:blue; background-color:yellow;" |∨

∧ ⍱ ⍲ bgcolor=cyan title="down caret" |∨ ∧ ⍱ ⍲ }}

{{#ifeq:{{{1}}}|6||title="take" style="border-width:thick; border-color:blue; background-color:yellow;" |↑

↓ ⊂ ⊃ ⌷ ⍋ ⍒
↓ ⊂ ⊃ ⌷ ⍋ ⍒
∊ ⍸ ⍷ ∪ ∩ ⊆ ⊇ ~ § π .. bgcolor=cyan title="iota" |⍳ ∊ ⍸ ⍷ ∪ ∩ ⊆ ⊇ ~ § π .. }}

{{#ifeq:{{{1}}}|8||title="comma" style="border-width:thick; border-color:blue; background-color:yellow;" |,

⍪ ⍴ ⌽ ⊖ ⍉
⍪ ⍴ ⌽ ⊖ ⍉
\ ⌿ ⍀ ⊙ ¨ ⍨ ⍤ ⍡ ⍥ ⍦ . ∘ ⍠ ‼ ⌻ ∂ ∫ bgcolor=cyan title="slash" |/ \ ⌿ ⍀ ⊙ ¨ ⍨ ⍤ ⍣ ⍡ ⍥ ⍦ . ∘ ⍠ ‼ ⌻ ∂ ∫ }}

{{#ifeq:{{{1}}}|10||title="quotequad" style="border-width:thick; border-color:blue; background-color:yellow;" |⍞

⎕ ⍎ ⍕
⎕ ⍎ ⍕
⍝ ∇ ∆ ⍙ _ ⍺ ⍵ bgcolor=cyan title="diamond" |⋄ ⍝ ∇ ∆ ⍙ _ ⍺ ⍵ }}

{{#ifeq:{{{1}}}|12||title="neg" style="border-width:thick; border-color:blue; background-color:yellow;" |¯

⍬ ∞ title="neg" |¯ ⍬ ∞ ∅
colspan=8 |Second Row i j k a b e g p r v x z colspan=8 |Second Row i j k a b e g p r v x z colspan=8 |Second Row i j k a b e g p r v x z colspan=6 |Second Row i j k i j k l g p r v x

}}

{{#ifeq:{{{1}}}|0| |[[Category:Mouse Group {{{1}}}|{{{2}}}]]}}




This NARS2000 article is a stub and needs further work.