\Header{object.size}{Report the Space Allocated for an Object}
\keyword{utilities}{object.size}
\begin{Description}\relax
Provides an estimate of the memory that is being used to store an \R{} object.
\end{Description}
\begin{Usage}
\begin{verbatim}
object.size(x)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] An \R{} object.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Exactly which parts of the memory allocation should be attributed
to which object is not clear-cut.  This function merely provides
a rough indication.  For example, it will not detect if character
storage for character strings are shared between identical elements
(which it will be if \code{rep} was used, for example).

The calculation is of the size of the object, and excludes the space
needed to store its name in the symbol table.
\end{Details}
\begin{Value}
An estimate of the memory allocation attributable to the object, in bytes.
\end{Value}
\begin{Examples}
\begin{ExampleCode}
object.size(letters)
object.size(ls)
## find the 10 largest objects in base
z <- sapply(ls("package:base"), function(x) object.size(get(x, envir=NULL)))
as.matrix(rev(sort(z))[1:10])
\end{ExampleCode}
\end{Examples}

