Skip to content

Extended Attributes R←X ⎕ATX Y

This function provides information about a name in a workspace, including its usage, history, restrictions, role and origin.

Note

To retrieve this information for an unnamed value, wrap ⎕ATX in a dfn and use the name ⍵, for example {60⎕ATX'⍵'}

Y can be a simple character scalar, a simple or enclosed character vector, or a vector of character scalars and vectors (as least one must be a character vector) of the name(s) for which information is required.

X can be a scalar or a vector indicating the information required:

Group X Meaning Default
Identity 0 Name ''
Syntax 10 Function result ( 0 : none or not a function, 1 : explicit, ¯1 : shy) 0
11 Function valence ( 0 : niladic, 1 : monadic, 2 : dyadic, ¯2 : ambivalent) 0
12 Operator valence: ( 0 : not an operator, 1 : monadic, 2 : dyadic) 0
Last edit 20 Author of last edit ''
21 Number of days passed between 1899-12-31 at 00:00 UTC and last edit (includes fractional days) 0
22 Local timestamp at last edit (format is the 7-item vector described by ⎕TS . See Timestamp ) ⍬
23 Number of bytes required for storage without sharing 0
Restrictions 30 Source can be displayed ¯1
31 Execution can be suspended mid-execution ¯1
32 Responds to weak interrupt ¯1
Class 40 Syntactic supra-class ( ¯1 : invalid name, 0 : undefined, 1 : label, 2 : variable, 3 : function, 4 : operator, 8 : event, 9 : object) ¯1
41 Syntactic sub-class ( 0 : none, 1 : traditional/plain, 2 : field/dynamic/instance, 3 : property/derived/primitive, 4 : class, 5 : interface, 6 : external, 7 : external interface) 0
42 Full syntactic class (sum of supra- and sub-class) ¯1
Source 50 File name ''
51 File encoding ''
52 File checksum ''
53 File line separators ( 13 : Carriage Return, 10 : Line Feed, 13 10 : Carriage Return followed by Line Feed, 133 : New Line, 11 : Vertical Tab, 12 : Form Feed, 8232 : Line Separator, 8233 : Paragraph Separator) ⍬
54 Definition's offset from top 0
55 Number of lines in definition 0
Definition 60 Verbatim source (as typed) 0⍴⊂''
61 Normalised source (with AUTOFORMAT=1 and TABSTOPS=4) 0⍴⊂''
62 Most precise available source (verbatim with fallback to normalised) 0⍴⊂''

Warning

Names in the Class group that can return ¯1 (meaning "invalid name") might return a different value in future versions of Dyalog, including values that are not currently possible and ones that deviate from the current ⎕NC values.

R depends on the combination of X and Y:

  X
  Scalar Vector
Y Simple character scalar/vector Requested value (not enclosed) Vector of requested values
Enclosed character vector Requested value (enclosed) Scalar containing vector of requested values
Vector of character scalars/vectors Vector of requested values Outer shape from ⍴⍺ , inner shape from ⍴⍵

Examples

      Att
10 11 12 20 23 30 31 32 40 41 42 50 51 52 53 54 55


      foo←{⍵ ⍵}
      Att ⎕ATX 'foo'
┌─┬──┬─┬┬───┬──┬──┬──┬─┬─┬───┬┬┬┬┬─┬─┐
│1│¯2│0││616│¯1│¯1│¯1│3│2│3.2│││││0│0│
└─┴──┴─┴┴───┴──┴──┴──┴─┴─┴───┴┴┴┴┴─┴─┘


      x←42
      Att ⎕ATX 'x'
┌─┬─┬─┬┬──┬──┬──┬──┬─┬─┬───┬┬┬┬┬─┬─┐
│0│0│0││32│¯1│¯1│¯1│2│1│2.1│││││0│0│
└─┴─┴─┴┴──┴──┴──┴──┴─┴─┴───┴┴┴┴┴─┴─┘


      10 11 12 30 31 32 40 41 42 ⎕ATX 'x' 'foo'
┌───┬────┬───┬─────┬─────┬─────┬───┬───┬───────┐
│0 1│0 ¯2│0 0│¯1 ¯1│¯1 ¯1│¯1 ¯1│2 3│1 2│2.1 3.2│
└───┴────┴───┴─────┴─────┴─────┴───┴───┴───────┘

      2 ⎕FIX'foo ← {' '⍵ ⍵ }'
      60 61 ⎕ATX 'foo'
┌───────────────┬──────────────────┐
│┌───────┬─────┐│┌──────┬─────────┐│
││foo ← {│⍵ ⍵ }│││ foo←{│     ⍵ ⍵}││
│└───────┴─────┘│└──────┴─────────┘│
└───────────────┴──────────────────┘

      src←':namespace c' ':endnamespace' '' 'range←{⍺↓⍳⍵}'
      2 ⎕FIX src
      55 54 ⎕ATX'c' 'range'
┌───┬───┐
│2 1│0 3│
└───┴───┘

      2 1↑¨0 3↓¨⊂src
┌────────────────────────────┬──────────────┐
│┌────────────┬─────────────┐│┌────────────┐│
││:namespace c│:endnamespace│││range←{⍺↓⍳⍵}││
│└────────────┴─────────────┘│└────────────┘│
└────────────────────────────┴──────────────┘
⎕ATX ATX