[#BloombergLP-bdlbb-BlobUtil-prependDataBufferIfValid-03]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlbb.adoc[bdlbb]::xref:BloombergLP/bdlbb/BlobUtil.adoc[BlobUtil]::prependDataBufferIfValid
:relfileprefix: ../../../
:mrdocs:

Prepend a moved data buffer to `dest` if size limits allow.

== Synopsis

Declared in `<bdlbb_blobutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
prependDataBufferIfValid(
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    xref:BloombergLP/bslmf/MovableRef.adoc[bslmf::MovableRef<BlobBuffer>] buffer);
----

== Description

Insert the specified move‐insertable `buffer` before the beginning of the specified `dest` if neither the resulting total size of `dest` nor its resulting total number of buffers exceeds `INT_MAX`. Return 0 on success, and a non‐zero value (with no effect) otherwise. The length of the `dest` is incremented by the length of the prepended buffer. In case of success the `buffer` is left in a valid but unspecified state.

== Return Value

0 on success, and a non‐zero value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *dest*
| destination blob
| *buffer*
| data buffer to move‐prepend
|===


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