[#nlohmann-basic_json-00-get-08]
= xref:nlohmann.adoc[nlohmann]::xref:nlohmann/basic_json-00.adoc[basic_json]::get
:relfileprefix: ../../
:mrdocs:

get a pointer value (explicit)

== Synopsis

Declared in `<nlohmann/json.hpp>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename PointerType>
requires std::is_pointer<PointerType>::value
decltype(std::declval<basic_json_t&>().template get_ptr<PointerType>())
get() noexcept;
----

== Description

Explicit pointer access to the internally stored JSON value. No copies are made.

[WARNING]
====
The pointer becomes invalid if the underlying JSON object changes.

====

Constant.

{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 `nullptr` is returned if the value and the requested pointer type does not match.,get__PointerType}

== Return Value

pointer to the internally stored JSON value if the requested pointer type _PointerType_ fits to the JSON value; `nullptr` otherwise

== Template Parameters

[cols=2]
|===
| Name
| Description
| *PointerType*
| pointer type; must be a pointer to xref:nlohmann/basic_json-00/array_t.adoc[`array_t`], xref:nlohmann/basic_json-00/object_t.adoc[`object_t`], xref:nlohmann/basic_json-00/string_t.adoc[`string_t`], xref:nlohmann/basic_json-00/boolean_t.adoc[`boolean_t`], xref:nlohmann/basic_json-00/number_integer_t.adoc[`number_integer_t`], xref:nlohmann/basic_json-00/number_unsigned_t.adoc[`number_unsigned_t`], or xref:nlohmann/basic_json-00/number_float_t.adoc[`number_float_t`].
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#