BloombergLP::bdlc::Queue::replace

Replace elements at dstIndex with elements from srcQueue.

Synopsis

Declared in <bdlc_queue.h>

void
replace(
    int dstIndex,
    Queue const& srcQueue,
    int srcIndex,
    int numElements);

Description

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); `

Parameters

NameDescription
dstIndexfirst index in this queue to replace
srcQueuequeue providing replacement values
srcIndexfirst index in srcQueue to copy from
numElementsnumber of elements to replace