\Header{matmult}{Matrix Multiplication}
\alias{\%*\%}{matmult}
\keyword{array}{matmult}
\keyword{arith}{matmult}
\begin{Description}\relax
Multiplies two matrices, if they are conformable.
If one argument is a vector, it will be coerced to a either a row or column
matrix to make the two arguments conformable.
If both are vectors it will return the inner product.\end{Description}
\begin{Usage}
\begin{verbatim}
a %*% b
\end{verbatim}
\end{Usage}
\begin{Value}
The matrix product.  Use \code{\Link{drop}} to get rid of dimensions
which have only one level.\end{Value}
\begin{SeeAlso}\relax
\code{\Link{matrix}},
\code{\Link{Arithmetic}},
\code{\Link{diag}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
x <- 1:4
(z <- x %*% x)    # scalar ("inner") product (1 x 1 matrix)
drop(z)             # as scalar

y <- diag(x)
z <- matrix(1:12, ncol = 3, nrow = 4)
y %*% z
y %*% x
x %*% z
\end{ExampleCode}
\end{Examples}

