| StackOverflows {base} | R Documentation |
Stack Overflow Errors
Description
Errors signaled byR when stacks used in evaluation overflow.
Details
R uses several stacks in evaluating expressions: the C stack, thepointer protection stack, and the node stack used by the byte codeengine. In addition, the number of nestedR expressions currentlyunder evaluation is limited by the value set asoptions("expressions"). Overflowing these stacks orlimits signals an error that inherits from classesstackOverflowError,error, andcondition.
The specific classes signaled are:
CStackOverflowError: Signaled when the C stackoverflows. Theusagefield of the error object contains thecurrent stack usage.protectStackOverflowError: Signaled when the pointerprotection stack overflows.nodeStackOverflowError: Signaled when the node stackused by the byte code engine overflows.expressionStackOverflowError: Signaled when the theevaluation depth, the number of nestedR expressions currentlyunder evaluation, exceeds the limit set byoptions("expressions")
Stack overflow errors can be caught and handled by exiting handlersestablished withtryCatch(). Calling handlers establishedbywithCallingHandlers() may fail since there may not beenough stack space to run the handler. In this case the next availableexiting handler will be run, or error handling will fall back to thedefault handler. Default handlers set bytryCatch("error") may also fail to run in a stackoverflow situation.
See Also
Cstack_info for information on the environment and theevaluation depth limit.
Memory andoptions for information on theprotection stack.