Report Information on C Stack Size and Usage (original) (raw)
Cstack_info {base} | R Documentation |
---|
Description
Report information on the C stack size and usage (if available).
Usage
Cstack_info()
Details
On most platforms, C stack information is recorded when R is initialized and used for stack-checking. If this information is unavailable, the size
will be returned as NA
, and stack-checking is not performed.
The information on the stack base address is thought to be accurate on Windows, Linux (using glibc
), macOS and FreeBSD but a heuristic is used on other platforms. Because this might be slightly inaccurate, the current usage could be estimated as negative. (The heuristic is not used on embedded uses of R on platforms where the stack base information is not thought to be accurate.)
The ‘evaluation depth’ is the number of nested R expressions currently under evaluation: this has a limit controlled by[options](../../base/help/options.html)("expressions")
.
Value
An integer vector. This has named elements
size | The size of the stack (in bytes), or NA if unknown. |
---|---|
current | The estimated current usage (in bytes), possibly NA. |
direction | 1 (stack grows down, the usual case) or-1 (stack grows up). |
eval_depth | The current evaluation depth (including two calls for the call to Cstack_info). |
Examples
Cstack_info()
[Package _base_ version 4.6.0 Index]