[#BloombergLP-bdlc-Queue-replace-0a]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlc.adoc[bdlc]::xref:BloombergLP/bdlc/Queue.adoc[Queue]::replace
:relfileprefix: ../../../
:mrdocs:

Replace the specified `numElements` values beginning at the specified `dstIndex` in this queue with values from the specified `srcQueue` beginning at the specified `srcIndex`. The behavior is undefined unless `0 <= dstIndex, 0 <= numElements`, `dstIndex + numElements <= length()`, `0 <= srcIndex`, and `srcIndex + numElements <= srcQueue.length()`. Note that this function is logically equivalent to (but more efficient than): ` insert(dstIndex, srcQueue, srcIndex, numElements); remove(dstIndex + numElements, numElements); `

== Synopsis

Declared in `<bdlc_queue.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
replace(
    int dstIndex,
    xref:BloombergLP/bdlc/Queue.adoc[Queue] const& srcQueue,
    int srcIndex,
    int numElements);
----


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