Skip to main content

Module stack

Module stack 

Source
Expand description

Running recursion-heavy work on a large, dedicated stack.

Some conversions recurse as deeply as their input nests (walking a document tree, decoding a deeply nested markup fragment), so a legitimately deep input can exhaust a small caller stack. on_deep_stack runs such work on a worker thread that reserves a generous stack for it.

Enums§

DeepStack
The outcome of running work on a dedicated large stack.

Constants§

DEEP_STACK
Virtual stack reserved for work whose recursion depth tracks input nesting. Large enough that even adversarially deep input cannot exhaust it; on demand-paged systems the reservation stays uncommitted until touched, so the cost is address space rather than resident memory.

Functions§

on_deep_stack
Runs work on a dedicated thread with a large reserved stack (DEEP_STACK), so deeply nested input cannot overflow the caller’s stack.