[#BloombergLP-bdljsn-Json-insert-064]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdljsn.adoc[bdljsn]::xref:BloombergLP/bdljsn/Json.adoc[Json]::insert
:relfileprefix: ../../../
:mrdocs:

Insert the specified move‐insertable `member` into the `JsonObject` held by this object if the key of `member` does not already exist; otherwise, this method has no effect. Return a `pair` whose `first` member is an iterator referring to the (possibly newly inserted) `Member` object whose key matches, and whose `second` member is `true` if a new value was inserted, and `false` otherwise. `member` is left in a valid but unspecified state. If `isNull()`, then the type is changed to object. The behavior is undefined unless `isObject()` or `isNull()`, and unless `member.first` is valid UTF‐8 (see `bdlde::Utf8Util::isValid`).

== Synopsis

Declared in `<bdljsn_json.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/pair-0b.adoc[bsl::pair<JsonObject::Iterator, bool>]
insert(xref:BloombergLP/bslmf/MovableRef.adoc[bslmf::MovableRef<JsonObject::Member>] member);
----


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