Name: get - retrieve element indexed Object of a container

Synopsis:

array/proc/litproc/string int --&gt; obj 
dict literal                  --&gt; obj 
dict array                    --&gt; obj


Examples:

(Hello World!)      0                  get --&gt; 184 
[(Hello) 1 /a 12]   1                  get --&gt; 1 
{(Hello World!) ==} 1                  get --&gt; == 
systemdict          /get               get --&gt; +get+ 
[/a /b /c /d] [0 2]                    get -&gt; [/a /c] 
&lt;&lt; /a 3 /c 2 &gt;&gt;  /c                    get --&gt; 2 
&lt;&lt; /a 3 /c 2 &gt;&gt;  [/c]                  get --&gt; 2 
&lt;&lt; /a 3 /c 2 &gt;&gt;  [[/c]]                get --&gt; [2] 
&lt;&lt; /a 3 /c 2 &gt;&gt;  [[/c /a /a]]          get --&gt; [2 3 3] 
&lt;&lt; /a &lt;&lt; /b 3 /c 2 &gt;&gt; &gt;&gt;  [/a /c]      get --&gt; 2 
&lt;&lt; /a &lt;&lt; /b 3 /c 2 &gt;&gt; &gt;&gt;  [/a [/b /c]] get --&gt; [3 2]


Description:

get will call the various typedependend get operators, returning 
the specified object. There are many possibilities for the 
combination of types, see examples. 
Alternatives: Functions get_a for arrays, get_p for procedures, 
get_lp for literal procedures, get_s for strings, get_d and get_d_a 
for dictionaries (all undocumented) 
-&gt; behavior and synopsis are the same.


Parameters:

array/proc/litproc/string/dict is the container, 
int/literal is the index for the lookup. 
The object returned depends on the container contents. 
For arrays it is also possible to use an array of indices. 
In this case, individual indices may appear more than once. 
For dictionaries the interpretation of the array argument is identical to 
the one of the index array of operator Part. This is useful to extract 
data from nested dictionaries and arranging them for further numerical 
processing. The array elements are sequentially applied from left to right 
to the object resulting from the get operation of the previous element. 
If an array element is itself an array, its elements are simultaneously 
applied to the argument and the result is an array of the same size. 
Applications of SLI like the NEST kernel may impliment variants 
of get to provide a homogeneous interface to further containers.


Author:

Gewaltig, Diesmann


FirstVersion:

??


SeeAlso:

get_d
put
Part
getinterval

Source:

/var/www/debian/nest/nest-simulator-2.20.0/lib/sli/sli-init.sli
