[#BloombergLP-bdlcc-Cache-insert-0e]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/Cache.adoc[Cache]::insert
:relfileprefix: ../../../
:mrdocs:

Insert the specified `key` and its associated `valuePtr` into this cache&period; If `key` already exists, then its value will be replaced with `value`&period; Note that the method with `key` moved provides the `basic` but not the `strong` exception guarantee &hyphen;&hyphen; if a throw occurs, the cache will not be modified, but `key` may be changed&period; Also note that `key` must be copyable, even if it is moved&period;

== Synopsis

Declared in `&lt;bdlcc&lowbar;cache&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
insert(
    KEY const& key,
    xref:BloombergLP/bdlcc/Cache/ValuePtrType.adoc[ValuePtrType] const& valuePtr);
----


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