Trace Copying of Objects
This function marks an object so that a message is printed whenever the internal code copies the object. It is a major cause of hard-to-predict memory use in R.
tracemem(x) untracemem(x) retracemem(x, previous = NULL)
- An R object, not a function or environment or
- A value as returned by
This functionality is optional, determined at compilation, because it
makes R run a little more slowly even when no objects are being
untracemem give errors when R is not
compiled with memory profiling;
retracemem does not (so it can be
left in code during development).
It is enabled in the CRAN OS X and Windows builds of R.
When an object is traced any copying of the object by the C function
duplicate produces a message to standard output, as does type
coercion and copying when passing arguments to
The message consists of the string
tracemem, the identifying
strings for the object being copied and the new object being created,
and a stack trace showing where the duplication occurred.
retracemem() is used to indicate that a variable should be
considered a copy of a previous variable (e.g., after subscripting).
The messages can be turned off with
It is not possible to trace functions, as this would conflict with
trace and it is not useful to trace
environments, promises, weak references, or external pointer objects, as
these are not duplicated.
These functions are primitive.
A character string for identifying the object in the trace output (an
address in hex enclosed in angle brackets), or
capabilities("profmem") to see if this was enabled for
this build of R.