sprintf

Synopsis

template <class FormatString, class T1, ..., class Tn>
int sprintf(char *dst, T1 a1, ..., Tn an);

Description

Wrapper of the sprintf function of the C library. It takes the format string as a compile-time string, which is an boost::metaparse::string. It type-checks the arguments based on the format string. When type-checking fails, this function emits a compilation error. When type-checking succeeds, this function calls the sprintf function of the C library. This thin wrapper is likely to be inlined in which case it has no runtime overhead compared to using sprintf without type-checking.

#include <mpllibs/safe_printf/sprintf.hpp>

Expression semantics

For any s boost::metaparse::string, buf char pointer and a1 ... an runtime objects:

mpllibs::safe_printf::sprintf<s>(buf, a1, ..., an)

When the number and types of a1 ... an are correct according to s, the format string, it is equivalent to

std::sprintf(buf, boost::mpl::c_str<s>::type::value, a1, ..., an)

otherwise it is a compilation error.

Example

char s[32];
mpllibs::safe_printf::sprintf<BOOST_METAPARSE_STRING("%d %d\n")>(s, 11, 13);

[up]