\Header{rle}{Run Length Encoding}
\alias{inverse.rle}{rle}
\alias{print.rle}{rle}
\keyword{manip}{rle}
\begin{Description}\relax
Compute the lengths and values of runs of equal values in a vector
-- or the reverse operation.\end{Description}
\begin{Usage}
\begin{verbatim}
rle(x)
print(x, digits = getOption("digits"), ...)
inverse.rle(x, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] a simple vector [as argument of rle()],\\
a class "rle" object [as argument of \code{print()} or
\code{inverse.rle()}].
\item[\code{digits, ...}] potentially further arguments to the
corresponding method.
\end{ldescription}
\end{Arguments}
\begin{Value}
\code{rle()} returns an object of class "rle" which is a list with
components
\begin{ldescription}
\item[\code{lengths}] an integer vector containing the length of each run.
\item[\code{values}] a vector of the same length as \code{lengths} with the
corresponding values.
\end{ldescription}


\code{inverse.rle()} is the inverse function of \code{rle()}.\end{Value}
\begin{Examples}
\begin{ExampleCode}
x <- rev(rep(6:10, 1:5))
rle(x)
## lengths [1:5]  5 4 3 2 1
## values  [1:5] 10 9 8 7 6

z <- c(TRUE,TRUE,FALSE,FALSE,TRUE,FALSE,TRUE,TRUE,TRUE)
rle(z)
rle(as.character(z))

stopifnot(x == inverse.rle(rle(x)),
          z == inverse.rle(rle(z)))
\end{ExampleCode}
\end{Examples}

