entries - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

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 'output=Array' option is passed, the returned data is stored in an Array.  This is convenient because Arrays do not flatten sequences, and therefore the ith element can be a proper sequence.   As a result 'nolist' is implicitly always true with this option and cannot be overridden.
 • 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 command $\mathrm{sort}\left(\mathrm{ids},'\mathrm{setorder}'\right)$. See the set order help page for more details.
 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{red}}\right]{,}\left[{\mathrm{black}}\right]{,}\left[{\mathrm{blue}}\right]{,}\left[{\mathrm{green}}\right]$ (1)
 > $\mathrm{entries}\left(t\right)$
 $\left[{\mathrm{rot}}\right]{,}\left[{\mathrm{schwarz}}\right]{,}\left[{\mathrm{blau}}\right]{,}\left[{\mathrm{gruen}}\right]$ (2)
 > $\mathrm{indices}\left(t,'\mathrm{nolist}'\right)$
 ${\mathrm{red}}{,}{\mathrm{black}}{,}{\mathrm{blue}}{,}{\mathrm{green}}$ (3)
 > $\mathrm{indices}\left(t,'\mathrm{pairs}'\right)$
 ${\mathrm{red}}{=}{\mathrm{rot}}{,}{\mathrm{black}}{=}{\mathrm{schwarz}}{,}{\mathrm{blue}}{=}{\mathrm{blau}}{,}{\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.
 • For more information on Maple 15 changes, see Updates in Maple 15.
 • The indexorder option was introduced in Maple 18.
 • For more information on Maple 18 changes, see Updates in Maple 18.
 • The indices and entries commands were updated in Maple 2023.
 • The output option was introduced in Maple 2023.
 • For more information on Maple 2023 changes, see Updates in Maple 2023.