The Fill command sets entries of the input Matrix, Vector, or Array A to the specified value val. The value must be of the same type as the input Matrix, Vector, or Array, or an error results. In addition, the input Matrix, Vector, or Array must have rectangular (dense) storage.

The additional parameters, num, offset, and skip, extend Fill command usage. For example, you can set every second element in a Vector, a specific row or column in a Matrix, all entries [4,*,*] in a C_order Array.

The use of these additional parameters is a programmer level feature, and requires detailed knowledge of the storage structure of multidimensional rtables under different data orderings (C_order and Fortran_order). For a description of storage under these orderings,  see Fortran_order.

Knowledge of these storage schemes becomes required when you want to compute the num, offset, and skip values to fill a row or column of a Matrix using the Fill command.

Filling the third column of a 6 x 10 C_order Matrix corresponds to acting on the elements $10\left(i-1\right)+\left(3-1\right)$ for i from 1 to 6.

- num is the number of elements to fill, which is 6

- offset is the offset of the first element to be filled, which is (3-1)=2

- skip is the distance between consecutive elements (the multiplier of the 'i' above), which is 10.

The resulting command is Fill(6,val,A,2,10).

In contrast, the same operation for a 6 x 10 Fortran_order Matrix corresponds to acting on the elements $\left(i-1\right)+6\left(3-1\right)$ for i from 1 to 6. In this case the command is Fill(6,val,A,12,1), which can be abbreviated to Fill(6,val,A,12). This is shown in the following examples.

The default values of the optional parameters are described as follows.

- offset is 0 (start at the very beginning)

- skip is 1 (fill all consecutive elements)

- num is chosen so that the operation does not exceed the storage of the rtable

This function is part of the ArrayTools package, so it can be used in the short form Fill(..) only after executing the command with(ArrayTools).  However, it can always be accessed through the long form of the command by using ArrayTools[Fill](..).

The Fill command is thread safe as of Maple 2023, provided that the rtable A is not shared between threads.

For more information on thread safety, see index/threadsafe.

$\mathrm{with}\left(\mathrm{ArrayTools}\right)\:$

$A≔\mathrm{Vector}\left[\mathrm{row}\right]\left(10\right)$

$A≔\left[\begin{array}{cccccccccc}0& 0& 0& 0& 0& 0& 0& 0& 0& 0\end{array}\right]$

$\mathrm{Fill}\left(1\,A\right)$

$A$

$\left[\begin{array}{cccccccccc}1& 1& 1& 1& 1& 1& 1& 1& 1& 1\end{array}\right]$

$\mathrm{Fill}\left(5\,2\,A\,0\,2\right)$

$A$

$\left[\begin{array}{cccccccccc}2& 1& 2& 1& 2& 1& 2& 1& 2& 1\end{array}\right]$

$\mathrm{Fill}\left(3\,A\,1\,2\right)$

$A$

$\left[\begin{array}{cccccccccc}2& 3& 2& 3& 2& 3& 2& 3& 2& 3\end{array}\right]$

$M≔\mathrm{Matrix}\left(6\,10\,\mathrm{order}=\mathrm{C\_order}\right)$

$M≔\left[\begin{array}{cccccccccc}0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\end{array}\right]$

$\mathrm{Fill}\left(2\,M\right)$

$M$

$\left[\begin{array}{cccccccccc}2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$

$\mathrm{Fill}\left(20\,3\,M\right)$

$M$

$\left[\begin{array}{cccccccccc}3& 3& 3& 3& 3& 3& 3& 3& 3& 3\\ 3& 3& 3& 3& 3& 3& 3& 3& 3& 3\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$

$\mathrm{Fill}\left(10\,0\,M\,40\right)$

$M$

$\left[\begin{array}{cccccccccc}3& 3& 3& 3& 3& 3& 3& 3& 3& 3\\ 3& 3& 3& 3& 3& 3& 3& 3& 3& 3\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$

$\mathrm{Fill}\left(6\,5\,M\,2\,10\right)$

$M$

$\left[\begin{array}{cccccccccc}3& 3& 5& 3& 3& 3& 3& 3& 3& 3\\ 3& 3& 5& 3& 3& 3& 3& 3& 3& 3\\ 2& 2& 5& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 5& 2& 2& 2& 2& 2& 2& 2\\ 0& 0& 5& 0& 0& 0& 0& 0& 0& 0\\ 2& 2& 5& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$

$M≔\mathrm{Matrix}\left(6\,10\,\mathrm{order}=\mathrm{Fortran\_order}\right)$

$M≔\left[\begin{array}{cccccccccc}0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\end{array}\right]$

$\mathrm{Fill}\left(2\,M\right)$

$M$

$\left[\begin{array}{cccccccccc}2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$

$\mathrm{Fill}\left(12\,3\,M\right)$

$M$

$\left[\begin{array}{cccccccccc}3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$

$\mathrm{Fill}\left(10\,0\,M\,4\,6\right)$

$M$

$\left[\begin{array}{cccccccccc}3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\\ 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\\ 3& 3& 2& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$

$\mathrm{Fill}\left(6\,5\,M\,12\right)$

$M$

$\left[\begin{array}{cccccccccc}3& 3& 5& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 5& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 5& 2& 2& 2& 2& 2& 2& 2\\ 3& 3& 5& 2& 2& 2& 2& 2& 2& 2\\ 0& 0& 5& 0& 0& 0& 0& 0& 0& 0\\ 3& 3& 5& 2& 2& 2& 2& 2& 2& 2\end{array}\right]$