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

Appends to a `dst` string given a format string, and zero or more additional arguments, returning `*dst` as a convenience for chaining purposes.

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename... Args>
std::string&
StrAppendFormat(
    std::string* dst,
    xref:absl/FormatSpec.adoc[FormatSpec<Args...>] const& format,
    Args const&... args);
----

== Description

Appends nothing in case of error (but possibly alters its capacity).

Example:

std::string orig("For example PI is approximately "); std::cout << StrAppendFormat(&orig, "%12.6f", 3.14);

== Return Value

A reference to `*dst`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *dst*
| The string to append to.
| *format*
| The format string.
| *args*
| The arguments substituted into the format string.
|===


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