Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
value_stack::reset

Prepare to build a new document.

Synopsis
void
reset(
    storage_ptr sp = {});
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.

Exception Safety

No-throw guarantee.

Parameters

Name

Description

sp

A pointer to the memory_resource to use for top-level value and all child values. The stack will acquire shared ownership of the memory resource until release or reset is called, or when the stack is destroyed.


PrevUpHomeNext