[#BloombergLP-bdljsn-JsonArray-insert-0e2] = xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdljsn.adoc[bdljsn]::xref:BloombergLP/bdljsn/JsonArray.adoc[JsonArray]::insert :relfileprefix: ../../../ :mrdocs: Insert at the specified `position` in this `JsonArray` the specified move‐insertable `json`, and return an iterator referring to the newly inserted element. `json` is left in a valid but unspecified state. If an exception is thrown, `this` is unaffected. Throw `bsl::length_error` if `size() == maxSize()`. The behavior is undefined unless `position` is an iterator in the range `[begin() .. end()]` (both endpoints included). == Synopsis Declared in `<bdljsn_json.h>` [source,cpp,subs="verbatim,replacements,macros,-callouts"] ---- xref:BloombergLP/bdljsn/JsonArray/Iterator-0d.adoc[JsonArray::Iterator] insert( xref:BloombergLP/bdljsn/JsonArray/ConstIterator.adoc[ConstIterator] position, xref:BloombergLP/bslmf/MovableRef.adoc[bslmf::MovableRef<Json>] json); ---- [.small]#Created with https://www.mrdocs.com[MrDocs]#