[#BloombergLP-bdlc-BitArray-insert-08]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlc.adoc[bdlc]::xref:BloombergLP/bdlc/BitArray.adoc[BitArray]::insert
:relfileprefix: ../../../
:mrdocs:

`insert` overloads

== Synopses

Declared in `<bdlc_bitarray.h>`

Insert into this array at the specified `dstIndex` the specified `value`. All values with indices at or above `dstIndex` in this array are shifted up by one bit position. The behavior is undefined unless `dstIndex <= length()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlc/BitArray/insert-063.adoc[insert](
    std::size_t dstIndex,
    bool value);
----

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

Insert into this array, beginning at the specified `dstIndex`, the values from the specified `srcArray`. All values with indices at or above `dstIndex` in this array are shifted up by `srcArray.length()` bit positions. The behavior is undefined unless `dstIndex <= length()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlc/BitArray/insert-06e.adoc[insert](
    std::size_t dstIndex,
    xref:BloombergLP/bdlc/BitArray.adoc[BitArray] const& srcArray);
----

[.small]#xref:BloombergLP/bdlc/BitArray/insert-06e.adoc[_» more..._]#

Insert into this array at the specified `dstIndex` the specified `numBits` having the specified `value`. All values with indices at or above `dstIndex` in this array are shifted up by `numBits` bit positions. The behavior is undefined unless `dstIndex <= length()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlc/BitArray/insert-05.adoc[insert](
    std::size_t dstIndex,
    bool value,
    std::size_t numBits);
----

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

Insert into this array, beginning at the specified `dstIndex`, the specified `numBits` from the specified `srcArray` beginning at the specified `srcIndex`. All values with initial indices at or above `dstIndex` are shifted up by `numBits` positions. The behavior is undefined unless `dstIndex <= length()` and `srcIndex + numBits <= srcArray.length()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlc/BitArray/insert-0a.adoc[insert](
    std::size_t dstIndex,
    xref:BloombergLP/bdlc/BitArray.adoc[BitArray] const& srcArray,
    std::size_t srcIndex,
    std::size_t numBits);
----

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


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