\Header{append}{Vector Merging}
\keyword{manip}{append}
\begin{Description}\relax
Add elements to a vector.\end{Description}
\begin{Usage}
\begin{verbatim}
append(x, values, after=length(x))
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] the vector to be modified.
\item[\code{values}] to be included in the modified vector.
\item[\code{after}] a subscript, after which the values are to be appended.
\end{ldescription}
\end{Arguments}
\begin{Value}
A vector containing the values in \code{x} with the elements of
\code{values} appended after the specified element of \code{x}.\end{Value}
\begin{Examples}
\begin{ExampleCode}
stopifnot(
    append(1:5, 0:1, after=3)
 == append(1:3, c(0:1, 4:5)))
\end{ExampleCode}
\end{Examples}

