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

Appends the contents of a `src` Cord to a `*dst` string.

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
AppendCordToString(
    xref:absl/Cord.adoc[Cord] const& src,
    std::string* dst);
----

== Description

This function optimizes the case of appending to a non‐empty destination string. If `*dst` already has capacity to store the contents of the cord, this function does not invalidate pointers previously returned by `dst‐>data()`. If `*dst` is a new object, prefer to simply use the conversion operator to `std::string`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *src*
| The Cord whose contents are appended.
| *dst*
| The string that receives the appended contents.
|===


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