Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
format_sql (1 of 2 overloads)

Composes a SQL query client-side.

Synopsis

Defined in header <boost/mysql/format_sql.hpp>

template<
    class... Formattable>
std::string
format_sql(
    format_options opts,
    constant_string_view format_str,
    Formattable&&... args);
Description

Parses format_str as a format string, substituting replacement fields (like {}, {1} or {name}) by formatted arguments, extracted from args. opts is using to parse the string and format string arguments.

Formatting is performed as if format_context::append_raw and format_context::append_value were called on a context created by this function.

Exception safety

Strong guarantee. Memory allocations may throw. boost::system::system_error is thrown if an error is found while formatting. See below for more info.

Errors

Convenience header <boost/mysql.hpp>


PrevUpHomeNext