The SearchArray(A) function returns a vector of numbers such that each element in the returned vector corresponds to an index of a non-zero entry in A.

The SearchArray(A, n) and SearchArray(A, n, location = first) functions return a vector of the first n indices corresponding to non-zero entries in A.

The SearchArray(A, n, location = last) function returns a vector of the last n indices corresponding to non-zero entries in A.

The row, col := SearchArray(A, ...) function returns two Vectors corresponding to the paired row and column indices for non-zero entries in A.

The row, col, val := SearchArray(A, ...) function returns two Vectors corresponding to the paired row and column indices for non-zero entries in A and returns in the third Vector the value of the array A at each of these positions.

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

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

$A≔\mathrm{Array}\left(\left[0\,3\,4\,0\,6\,8\,9\right]\right)$

$A≔\left[\begin{array}{ccccccc}0& 3& 4& 0& 6& 8& 9\end{array}\right]$

$\mathrm{SearchArray}\left(A\right)$

$\left[\begin{array}{c}2\\ 3\\ 5\\ 6\\ 7\end{array}\right]$

$\mathrm{SearchArray}\left(A\,4\,\mathrm{location}\=\mathrm{first}\right)$

$\left[\begin{array}{c}2\\ 3\\ 5\\ 6\end{array}\right]$

$\mathrm{SearchArray}\left(A\,4\,\mathrm{location}\=\mathrm{last}\right)$

$\left[\begin{array}{c}3\\ 5\\ 6\\ 7\end{array}\right]$

$B≔\mathrm{Array}\left(\left[\left[1\,2\right]\,\left[0\,9\right]\,\left[7\,0\right]\,\left[-6\,4\right]\right]\right)$

$B≔\left[\begin{array}{cc}1& 2\\ 0& 9\\ 7& 0\\ \mathrm{-6}& 4\end{array}\right]$

$\mathrm{row}\,\mathrm{col}≔\mathrm{SearchArray}\left(B\right)$

$\mathrm{row},\mathrm{col}≔\left[\begin{array}{c}1\\ 3\\ 4\\ 1\\ 2\\ 4\end{array}\right],\left[\begin{array}{c}1\\ 1\\ 1\\ 2\\ 2\\ 2\end{array}\right]$

$\mathrm{row}\,\mathrm{col}\,\mathrm{val}≔\mathrm{SearchArray}\left(B\right)$

$\mathrm{row},\mathrm{col},\mathrm{val}≔\left[\begin{array}{c}1\\ 3\\ 4\\ 1\\ 2\\ 4\end{array}\right],\left[\begin{array}{c}1\\ 1\\ 1\\ 2\\ 2\\ 2\end{array}\right],\left[\begin{array}{c}1\\ 7\\ \mathrm{-6}\\ 2\\ 9\\ 4\end{array}\right]$

$\mathrm{row}\,\mathrm{col}\,\mathrm{val}≔\mathrm{SearchArray}\left(B\,4\right)$

$\mathrm{row},\mathrm{col},\mathrm{val}≔\left[\begin{array}{c}1\\ 3\\ 4\\ 1\end{array}\right],\left[\begin{array}{c}1\\ 1\\ 1\\ 2\end{array}\right],\left[\begin{array}{c}1\\ 7\\ \mathrm{-6}\\ 2\end{array}\right]$