[#BloombergLP-bdlbb-BlobUtil-append-09]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlbb.adoc[bdlbb]::xref:BloombergLP/bdlbb/BlobUtil.adoc[BlobUtil]::append
:relfileprefix: ../../../
:mrdocs:

`append` overloads

== Synopses

Declared in `<bdlbb_blobutil.h>`

Append the specified `source` to the specified `dest`. Note that the data memory from `source` is not copied, but rather new `BlobBuffer`s referring to the same data memory are created and appended to `dest`, hence `dest` is not required to have a `BlobBufferFactory`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-03.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    xref:BloombergLP/bdlbb/Blob.adoc[Blob] const& source);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-03.adoc[_» more..._]#

Append the specified `length` bytes to the specified `dest`, all new bytes are to be set to the specified `fill`. The behavior is undefined unless `length <= dest‐>totalSize() ‐ dest‐>length()` or `0 != dest‐>factory()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-0e.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    int length,
    char fill);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-0e.adoc[_» more..._]#

Append from the specified `offset` in the specified `source` to the specified `dest`. Note that the data memory from `source` is not copied, but rather new `BlobBuffer`s referring to the same data memory are created and appended to `dest`, hence `dest` is not required to have a `BlobBufferFactory`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-086.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    xref:BloombergLP/bdlbb/Blob.adoc[Blob] const& source,
    int offset);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-086.adoc[_» more..._]#

See the corresponding non‐deprecated `append` overload above. The allocator argument is unused.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-05.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    xref:BloombergLP/bdlbb/Blob.adoc[Blob] const& source,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]*);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-05.adoc[_» more..._]#

Append the specified `length` bytes starting from the specified `source` address to the specified `dest`. The behavior is undefined unless the range `[source, source + length)]` is valid memory, and `length <= dest‐>totalSize() ‐ dest‐>length()` or `0 != dest‐>factory()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-01.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    char const* source,
    int length);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-01.adoc[_» more..._]#

Append the specified `length` bytes from the specified `offset` in the specified `source` to the specified `dest`. Note that the data memory from `source` is not copied, but rather new `BlobBuffer`s referring to the same data memory are created and appended to `dest`, hence `dest` is not required to have a `BlobBufferFactory`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-04.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    xref:BloombergLP/bdlbb/Blob.adoc[Blob] const& source,
    int offset,
    int length);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-04.adoc[_» more..._]#

See the corresponding non‐deprecated `append` overload above. The allocator argument is unused.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-08b.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    xref:BloombergLP/bdlbb/Blob.adoc[Blob] const& source,
    int offset,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]*);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-08b.adoc[_» more..._]#

Append the specified `length` bytes starting from the specified `offset` from the specified `source` address to the specified `dest`. The behavior of this function is undefined unless the range `[source + offset, source + offset + length)]` represents a readable sequence of memory, and `length <= dest‐>totalSize() ‐ dest‐>length()` or `0 != dest‐>factory()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-06.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    char const* source,
    int offset,
    int length);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-06.adoc[_» more..._]#

See the corresponding non‐deprecated `append` overload above. The allocator argument is unused.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bdlbb/BlobUtil/append-0c.adoc[append](
    xref:BloombergLP/bdlbb/Blob.adoc[Blob]* dest,
    xref:BloombergLP/bdlbb/Blob.adoc[Blob] const& source,
    int offset,
    int length,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]*);
----

[.small]#xref:BloombergLP/bdlbb/BlobUtil/append-0c.adoc[_» more..._]#


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