template<typename PointerType> PointerType get_ptr(); template<typename PointerType> constexpr const PointerType get_ptr() const noexcept;
Implicit pointer access to the internally stored JSON value. No copies are made.
PointerType
: pointer type; must be a pointer to array_t
, object_t
, string_t
, boolean_t
, number_integer_t
, or number_unsigned_t
, number_float_t
, or binary_t
. Other types will not compile.
pointer to the internally stored JSON value if the requested pointer type fits to the JSON value; #!cpp nullptr
otherwise
Strong exception safety: if an exception occurs, the original value stays intact.
Constant.
!!! warning
Writing data to the pointee of the result yields an undefined state.
??? example
The example below shows how pointers to internal values of a JSON value can be requested. Note that no type conversions are made and a `#!cpp nullptr` is returned if the value and the requested pointer type does not match. ```cpp --8<-- "examples/get_ptr.cpp" ``` Output: ```json --8<-- "examples/get_ptr.output" ```