\Header{interweave}{interweave}
\keyword{manip}{interweave}
\begin{Description}\relax
The first object is "interweaved" with the second object
and the resulting object with the following object and
continued as long as the last object is reached.
Note: \code{AsIs} class objects are coerced to a vector
before interweaving starts.
\end{Description}
\begin{Usage}
\begin{verbatim}interweave(...)\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{...}] vectors, matrices, one- and two-dimensional arrays;
an \code{AsIs} class object is coerced to a vector.
\end{ldescription}
\end{Arguments}
\begin{Value}
An "interweaved" object, cf. example.
\end{Value}
\begin{Author}\relax
Andreas Buness <a.buness@dkfz.de>
\end{Author}
\begin{Examples}
\begin{ExampleCode}
    x <- seq(1,100,2)
    y <- seq(2,100,2)
    z <- interweave(x,y)
    stopifnot( all.equal(z,1:100) )
        \end{ExampleCode}
\end{Examples}

