\Header{row}{Row Indexes}
\keyword{array}{row}
\begin{Description}\relax
Returns a matrix of integers indicating their row number in the
matrix.\end{Description}
\begin{Usage}
\begin{verbatim}
row(x, as.factor = FALSE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] a matrix.
\item[\code{as.factor}] a logical value indicating whether the value should
be returned as a factor rather than as numeric.
\end{ldescription}
\end{Arguments}
\begin{Value}
An integer matrix with the same dimensions as \code{x} and whose
\code{ij}-th element is equal to \code{i}.\end{Value}
\begin{SeeAlso}\relax
\code{\Link{col}} to get columns.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
x <- matrix(1:12, 3, 4)
# extract the diagonal of a matrix
dx <- x[row(x) == col(x)]
dx

# create an identity 5-by-5 matrix
x <- matrix(0, nr = 5, nc = 5)
x[row(x) == col(x)] <- 1
x
\end{ExampleCode}
\end{Examples}

