[#BloombergLP-bdlbb-Blob-insertBuffer-0c]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlbb.adoc[bdlbb]::xref:BloombergLP/bdlbb/Blob.adoc[Blob]::insertBuffer
:relfileprefix: ../../../
:mrdocs:

Insert the specified move‐insertable `buffer` at the specified `index` in this blob. Increment the length of this blob by the size of `buffer` if `buffer` is inserted _before_ the logical end of this blob. The length of this blob is if inserting at a position following all data buffers (e.g., inserting into an empty blob or inserting a buffer to increase capacity); in that case, the blob length must be changed by an explicit call to `setLength`. Buffers at `index` and higher positions (if any) are shifted up by one index position. The `buffer` is left in a valid but unspecified state. The behavior is undefined unless `0 <= index <= numBuffers()` and neither the total size of the resulting blob nor its total number of buffers exceeds `INT_MAX`.

== Synopsis

Declared in `<bdlbb_blob.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
insertBuffer(
    int index,
    xref:BloombergLP/bslmf/MovableRef.adoc[bslmf::MovableRef<BlobBuffer>] buffer);
----


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