BloombergLP::bslfmt::format_to

Format args per fmtStr into the output iterator out.

Synopsis

Declared in <bslfmt_format_imp.h>

template<
    class t_OUT,
    class... t_ARGS>
t_OUT
format_to(
    t_OUT out,
    bslfmt::format_string<t_ARGS...> fmtStr,
    t_ARGS const&... args)
requires !bsl::is_same<typename bsl::decay<t_OUT>::type, bsl::string *>::value;

Description

Format the specified args according to the specification given by the specified fmtStr, and write the result of this operation into the output iterator given by the specified out parameter. In the event of an error the exception format_error is thrown. Behavior is undefined if out does not point to a valid output parameter.

Return Value

output iterator after writing

Parameters

NameDescription
outoutput iterator receiving formatted characters
fmtStrformat string
argsvalues to format