![]() |
Home | Libraries | People | FAQ | More |
Formats a value and adds it to the output string (low level).
format_context_base& append_value(formattable_refvalue,constant_string_viewformat_specifiers =string_view());
value is formatted according to its type, applying the passed format specifiers. If formatting generates an error (for instance, a string with invalid encoding is passed), the error state may be set.
This is a low level function. In general, prefer format_sql_to, instead.
Basic guarantee. Memory allocations may throw.
The error state may be updated with the following errors:
client_errc::invalid_encoding
if a string with byte sequences that can't be decoded with the current
character set is passed.
client_errc::unformattable_value
if a NaN or infinity float
or double is passed.
client_errc::format_string_invalid_specifier
if format_specifiers
includes specifiers not supported by the type being formatted.
add_error.