[#absl-Cord-GetCustomAppendBuffer]
= xref:absl.adoc[absl]::xref:absl/Cord.adoc[Cord]::GetCustomAppendBuffer
:relfileprefix: ../../
:mrdocs:

Returns a CordBuffer, re‐using potential existing capacity in this cord.

== Synopsis

Declared in `<absl/strings/cord.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:absl/CordBuffer.adoc[CordBuffer]
GetCustomAppendBuffer(
    size_t block_size,
    size_t capacity,
    size_t min_capacity = 16);
----

== Description

This function is identical to `GetAppendBuffer`, except that in the case where a new `CordBuffer` is allocated, it is allocated using the provided custom limit instead of the default limit. `GetAppendBuffer` will default to `CordBuffer::CreateWithDefaultLimit(capacity)` whereas this method will default to `CordBuffer::CreateWithCustomLimit(block_size, capacity)`. This method is equivalent to `GetAppendBuffer` if `block_size` is zero. See the documentation for `CreateWithCustomLimit` for more details on the restrictions and legal values for `block_size`.

== Return Value

A CordBuffer reusing spare capacity when available.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *block_size*
| The custom allocation limit for a newly allocated buffer.
| *capacity*
| The desired capacity of the returned buffer.
| *min_capacity*
| The minimum extra capacity required to reuse existing spare capacity.
|===


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