[#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 all buffers from `source` onto `dest` without copying data.


[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 fill bytes to bring `dest` to a greater length.


[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 buffers from `source` starting at `offset` onto `dest`.


[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..._]#

Append all of `source` onto `dest` (allocator 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]* basicAllocator);
----

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

Append bytes from a contiguous address onto `dest`.


[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 a range of buffers from `source` onto `dest` without copying.


[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..._]#

Append from `offset` in `source` onto `dest` (allocator 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]* basicAllocator);
----

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

Append a byte range from a contiguous address onto `dest`.


[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..._]#

Append a range from `source` onto `dest` (allocator 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]* basicAllocator);
----

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

== Parameters

[cols="1,4"]
|===
| Name| Description
| *dest*
| destination blob
| *source*
| source blob whose buffers are shared into `dest`
| *length*
| number of fill bytes to append
| *fill*
| byte value used for each appended byte
| *offset*
| starting byte offset in `source`
| *basicAllocator*
| unused allocator argument
|===


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