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 |
|---|---|
|
A pointer to the |