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 |