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

`insert` overloads

== Synopses

Declared in `<bdlc_queue.h>`

Insert the specified `srcQueue` into this queue at the specified `dstIndex`. All current values with indices at or above `dstIndex` are shifted up by `srcQueue.length()` index positions. The behavior is undefined unless `0 <= dstIndex <= length()`.


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

[.small]#xref:BloombergLP/bdlc/Queue/insert-095.adoc[_» more..._]#

Insert the specified `item` into this queue at the specified `dstIndex`. All current values with indices at or above `dstIndex` are shifted up by one index position. The behavior is undefined unless `0 <= dstIndex <= length()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlc/Queue/insert-09c.adoc[insert](
    int dstIndex,
    T const& item);
----

[.small]#xref:BloombergLP/bdlc/Queue/insert-09c.adoc[_» more..._]#

Insert the specified `numElements` values starting at the specified `srcIndex` position from the specified `srcQueue` into this queue at the specified `dstIndex`. All current values with indices at or above `dstIndex` are shifted up by `numElements` index positions. The behavior is undefined unless `0 <= dstIndex <= length()`, `0 <= srcIndex`, `0 <= numElements`, and `srcIndex + numElements <= srcQueue.length()`.


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

[.small]#xref:BloombergLP/bdlc/Queue/insert-0b.adoc[_» more..._]#


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