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

Returns a CordBuffer, re&hyphen;using potential existing capacity in this cord&period;

== Synopsis

Declared in `&lt;absl&sol;strings&sol;cord&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:absl/CordBuffer.adoc[CordBuffer]
GetCustomAppendBuffer(
    size&lowbar;t block&lowbar;size,
    size&lowbar;t capacity,
    size&lowbar;t min&lowbar;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&period; `GetAppendBuffer` will default to `CordBuffer&colon;&colon;CreateWithDefaultLimit(capacity)` whereas this method will default to `CordBuffer&colon;&colon;CreateWithCustomLimit(block&lowbar;size, capacity)`&period; This method is equivalent to `GetAppendBuffer` if `block&lowbar;size` is zero&period; See the documentation for `CreateWithCustomLimit` for more details on the restrictions and legal values for `block&lowbar;size`&period;

== Return Value

A CordBuffer reusing spare capacity when available&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *block&lowbar;size*
| The custom allocation limit for a newly allocated buffer&period;
| *capacity*
| The desired capacity of the returned buffer&period;
| *min&lowbar;capacity*
| The minimum extra capacity required to reuse existing spare capacity&period;
|===


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