value_stack::reset

Prepare to build a new document.

Synopsis

void
reset(
    storage_ptr sp = {}) noexcept;

Description

This function must be called before constructing a new top-level value. Any previously existing partial or complete elements are destroyed, but internal dynamically allocated memory is preserved which may be reused to build new values.

The stack will acquire shared ownership of the memory resource pointed to by sp until release or reset is called, or when the stack is destroyed.

Exception Safety

No-throw guarantee.

Parameters

Name Description

sp

A pointer to the boost::container::pmr::memory_resource to use for top-level value and all child values.