A C++ template library for embedded applications
MIT licensed
Designed and
maintained by
John Wellbelove
Support the development
of the ETL

to_string



Functions that will render a text representation of bools, integrals, floating point, strings, string views and pointers.
Uses etl::basic_format_spec to define the required formatting.

It will convert to any of the ETL string types.
____________________________________________________________________________________________________

Default format specification
Where StringType is etl::istring, etl::iwstring, etl::iu16string or etl::iu32string

template <typename T>
const StringType& to_string(const T value,
                            StringType& str,
                            const bool append = false)

20.17.0
template <typename T> // Where T is an integral
const StringType& to_string(const T value,
                            uint32_t denominator_exponent,
                            StringType& str,
                            const bool append = false)

value   The value to convert to a string.
str     The string in with to place the rendered text.
append  If true then appends the text to the current string's content. Default false.
____________________________________________________________________________________________________

Supplied format specification
Where StringType is etl::istring, etl::iwstring, etl::iu16string or etl::iu32string
Where FormatType is etl::format_spec, etl::wformat_spec, etl::u16format_spec or etl::u32format_spec

template <typename T>
const StringType& to_string(const T value,
                            StringType& str,
                            const FormatType& format,
                            const bool append = false)

20.17.0
template <typename T> // Where T is an integral
const StringType& to_string(const T value,
                            uint32_t denominator_exponent,
                            StringType& str,
                            const FormatType& format,
                            const bool append = false)

value                The value to convert to a string.
denominator_exponent The exponent of the value that is used to divide the value.
str                  The string in with to place the rendered text.
format               The format specification.
append               If true then appends the text to the current string's content. Default false.
____________________________________________________________________________________________________
Examples

Format as a hex character, minimum fill width of 8, fill with zeros

etl::format_spec format;

// Format as a hex character, minimum fill width of 8, fill with zeros.
format.hex().width(8).fill('0');

etl::string<8> text;

// 'text' is set to "00123456"
etl::to_string(1193046, text, format);
____________________________________________________________________________________________________

Format minimum fill width of 8, fill with space and three decimal digits

etl::format_spec format;

// Format minimum fill width of 8, fill with space and three decimal digits.
format.width(8).fill(' ').precision(3);

etl::string<8> text;

// 'text' is set to "   3.142"
etl::to_string(3.1415, text, format);
____________________________________________________________________________________________________

Format a floating point number


etl::string<19> text = "The result is ";

etl::to_string(3.1415, text, etl::format_spec().precision(3), true);
// 'text' is set to "The result is 3.142"
____________________________________________________________________________________________________

Format an integral number and divide by 10000

etl::string<19> text = "The result is ";

etl::to_string(31415, 4U, text, etl::format_spec().precision(3), true);
// 'text' is set to "The result is 3.142"
to_string.h, to_wstring.h, to_u16string.h, to_u32string.h