[#nlohmann-basic_json-0c-insert_iterator]
= xref:nlohmann.adoc[nlohmann]::xref:nlohmann/basic_json-0c.adoc[basic_json]::insert_iterator
:relfileprefix: ../../
:mrdocs:

helper for insertion of an iterator

== Synopsis

Declared in `<nlohmann/json.hpp>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename... Args>
xref:nlohmann/basic_json-0c/iterator.adoc[iterator]
insert_iterator(
    xref:nlohmann/basic_json-0c/const_iterator.adoc[const_iterator] pos,
    Args&&... args);
----

== Description

[NOTE]
====
: This uses std::distance to support GCC 4.8, see https://github.com/nlohmann/json/pull/1257

====

== Return Value

iterator pointing to the first element inserted, or `pos` if no element was inserted

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pos*
| iterator before which the content will be inserted into the array
| *args*
| arguments forwarded to the underlying array's `insert()`
|===


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