entries - Maple Help

indices

indices of a table or array

entries

entries of a table or array

 Calling Sequence indices(t) indices(t, options) entries(t) entries(t, options)

Parameters

 t - list, set, table, Array, Vector, Matrix, or object options - (optional) optional arguments to control the output format

Description

 • The indices and entries functions return sequences of the indices (or keys) and the entries respectively of the list, set, table, Array, Vector, Matrix, or container object t corresponding to the entries that are explicitly stored.
 • By default, the result returned is a sequence of lists in an apparently arbitrary order. However, there is a one-to-one correspondence between the result of indices and entries. The 'indexorder' option can be specified to control the order of the returned elements.
 • indices and entries support the following optional arguments.
 • If the 'nolist' option is passed, the result returned is a simple sequence of values not enclosed within lists. This is useful for containers where every index or entry is known to be a single object. When 'nolist' is used on a container with expression sequence indices or entries, the groupings may be difficult or impossible to discern in the result.
 • If the 'pairs' option is passed, the result returned is a sequence of index = entry pairs. Since the equation form can represent sequences on each side of the equation, neither each side nor the whole equation is wrapped in a list, regardless of the presence or absence of 'nolist'.
 • If the 'indexorder' option is passed, the returned data is ordered based on the sorted order of the indices. The indices are sorted using the same algorithm as the sort command.
 A specific comparison function can be provided using 'indexorder'=func, where func is a procedure taking two arguments and returning true if and only if the first is to come before the second.
 The 'indexorder' option is supported only for table, Array, Vector, and Matrix containers.

 • The indices and entries commands are thread-safe as of Maple 15.

Examples

 > $t≔\mathrm{table}\left(\left[\mathrm{green}=\mathrm{gruen},\mathrm{red}=\mathrm{rot},\mathrm{blue}=\mathrm{blau},\mathrm{black}=\mathrm{schwarz}\right]\right):$
 > $\mathrm{indices}\left(t\right)$
 $\left[{\mathrm{black}}\right]{,}\left[{\mathrm{blue}}\right]{,}\left[{\mathrm{red}}\right]{,}\left[{\mathrm{green}}\right]$ (1)
 > $\mathrm{entries}\left(t\right)$
 $\left[{\mathrm{schwarz}}\right]{,}\left[{\mathrm{blau}}\right]{,}\left[{\mathrm{rot}}\right]{,}\left[{\mathrm{gruen}}\right]$ (2)
 > $\mathrm{indices}\left(t,'\mathrm{nolist}'\right)$
 ${\mathrm{black}}{,}{\mathrm{blue}}{,}{\mathrm{red}}{,}{\mathrm{green}}$ (3)
 > $\mathrm{indices}\left(t,'\mathrm{pairs}'\right)$
 ${\mathrm{black}}{=}{\mathrm{schwarz}}{,}{\mathrm{blue}}{=}{\mathrm{blau}}{,}{\mathrm{red}}{=}{\mathrm{rot}}{,}{\mathrm{green}}{=}{\mathrm{gruen}}$ (4)
 > $\mathrm{indices}\left(t,\mathrm{indexorder}\right)$
 $\left[{\mathrm{black}}\right]{,}\left[{\mathrm{blue}}\right]{,}\left[{\mathrm{green}}\right]{,}\left[{\mathrm{red}}\right]$ (5)
 > $\mathrm{entries}\left(t,\mathrm{indexorder}\right)$
 $\left[{\mathrm{schwarz}}\right]{,}\left[{\mathrm{blau}}\right]{,}\left[{\mathrm{gruen}}\right]{,}\left[{\mathrm{rot}}\right]$ (6)
 > $\mathrm{indices}\left(t,\mathrm{=}\left(\mathrm{indexorder},\left(x,y\right)↦\mathbf{not}\phantom{\rule[-0.0ex]{0.3em}{0.0ex}}\mathrm{StringTools}:-\mathrm{Compare}\left(x\left[1\right],y\left[1\right]\right)\right)\right)$
 $\left[{\mathrm{red}}\right]{,}\left[{\mathrm{green}}\right]{,}\left[{\mathrm{blue}}\right]{,}\left[{\mathrm{black}}\right]$ (7)
 > $a≔\mathrm{Array}\left(\left[\left[1,2\right],\left[3,4\right]\right]\right)$
 ${a}{≔}\left[\begin{array}{cc}{1}& {2}\\ {3}& {4}\end{array}\right]$ (8)
 > $\mathrm{indices}\left(a\right)$
 $\left[{1}{,}{1}\right]{,}\left[{2}{,}{1}\right]{,}\left[{1}{,}{2}\right]{,}\left[{2}{,}{2}\right]$ (9)
 > $\mathrm{entries}\left(a\right)$
 $\left[{1}\right]{,}\left[{3}\right]{,}\left[{2}\right]{,}\left[{4}\right]$ (10)
 > $\mathrm{entries}\left(a,'\mathrm{nolist}'\right)$
 ${1}{,}{3}{,}{2}{,}{4}$ (11)
 > $m≔\mathrm{Matrix}\left(3,2,\left[\left[2,-1\right],\left[4,4\right],\left[5,8\right]\right]\right)$
 ${m}{≔}\left[\begin{array}{cc}{2}& {-1}\\ {4}& {4}\\ {5}& {8}\end{array}\right]$ (12)
 > $\mathrm{indices}\left(m\right)$
 $\left[{1}{,}{1}\right]{,}\left[{2}{,}{1}\right]{,}\left[{3}{,}{1}\right]{,}\left[{1}{,}{2}\right]{,}\left[{2}{,}{2}\right]{,}\left[{3}{,}{2}\right]$ (13)
 > $\mathrm{entries}\left(m\right)$
 $\left[{2}\right]{,}\left[{4}\right]{,}\left[{5}\right]{,}\left[{-1}\right]{,}\left[{4}\right]{,}\left[{8}\right]$ (14)
 > $\mathrm{entries}\left(m,'\mathrm{pairs}'\right)$
 $\left({1}{,}{1}\right){=}{2}{,}\left({1}{,}{2}\right){=}{-1}{,}\left({2}{,}{1}\right){=}{4}{,}\left({2}{,}{2}\right){=}{4}{,}\left({3}{,}{1}\right){=}{5}{,}\left({3}{,}{2}\right){=}{8}$ (15)

Compatibility

 • The pairs option was introduced in Maple 15.