The Maxima on-line user's manual

Algebra Calculator

Listarray

Function: listarray (<A>) Returns a list of the elements of the array <A>. The argument <A> may be a declared array, an undeclared (hashed) array, an array function, or a subscripted function.

Elements are listed in row-major order. That is, elements are sorted according to the first index, then according to the second index, and so on. The sorting order of index values is the same as the order established by `orderless`.

For undeclared arrays, array functions, and subscripted functions, the elements correspond to the index values returned by `arrayinfo`.

Unbound elements of declared general arrays (that is, not `fixnum` and not `flonum`) are returned as `#####`. Unbound elements of declared `fixnum` or `flonum` arrays are returned as 0 or 0.0, respectively. Unbound elements of undeclared arrays, array functions, and subscripted functions are not returned.

Examples:

`listarray` and `arrayinfo` applied to a declared array.

```          (%i1) array (aa, 2, 3);
(%o1)                          aa
(%i2) aa [2, 3] : %pi;
(%o2)                          %pi
(%i3) aa [1, 2] : %e;
(%o3)                          %e
(%i4) listarray (aa);
(%o4) [#####, #####, #####, #####, #####, #####, %e, #####,
#####, #####, #####, %pi]
(%i5) arrayinfo (aa);
(%o5)                 [declared, 2, [2, 3]]```

`listarray` and `arrayinfo` applied to an undeclared (hashed) array.

```          (%i1) bb [FOO] : (a + b)^2;
2
(%o1)                       (b + a)
(%i2) bb [BAR] : (c - d)^3;
3
(%o2)                       (c - d)
(%i3) listarray (bb);
3         2
(%o3)                 [(c - d) , (b + a) ]
(%i4) arrayinfo (bb);
(%o4)               [hashed, 1, [BAR], [FOO]]```

`listarray` and `arrayinfo` applied to an array function.

```          (%i1) cc [x, y] := y / x;
y
(%o1)                      cc     := -
x, y    x
(%i2) cc [u, v];
v
(%o2)                           -
u
(%i3) cc [4, z];
z
(%o3)                           -
4
(%i4) listarray (cc);
z  v
(%o4)                        [-, -]
4  u
(%i5) arrayinfo (cc);
(%o5)              [hashed, 2, [4, z], [u, v]]```

`listarray` and `arrayinfo` applied to a subscripted function.

```          (%i1) dd [x] (y) := y ^ x;
x
(%o1)                     dd (y) := y
x
(%i2) dd [a + b];
b + a
(%o2)                  lambda([y], y     )
(%i3) dd [v - u];
v - u
(%o3)                  lambda([y], y     )
(%i4) listarray (dd);
b + a                v - u
(%o4)      [lambda([y], y     ), lambda([y], y     )]
(%i5) arrayinfo (dd);
(%o5)             [hashed, 1, [b + a], [v - u]]```

```(%o1)                                true
(%i2) ```

Related Examples

listarray

for i thru 4 do for j...

listarray(A);

Calculate

x[1,1,1]:1;

x[1,2,1]:4;

listarray (x);

Calculate

? listarray;

Calculate

listarray

for i thru 4 do for j...

listarray(A);

Calculate

x[1,1,1]:1;

x[1,2,1]:4;

listarray (x);

Calculate

? listarray;

Calculate