Write the specified value into the character buffer [first, last)].
Declared in <bslstl_charconv.h>
template<class INTEGRAL_TYPE>
to_chars_result
to_chars(
char* first,
char* last,
INTEGRAL_TYPE value,
int base = 10);Optionally specify base, the base in which the number is to be written. If base is not specified, decimal is used. Return a to_chars_result struct indicating success or failure, and the end of the written result. On success, the output string is to begin at first, the ptr field in the return value is to point at the end of the representation, and the ec field will be 0. If the buffer specified by [ first .. last )] is not large enough for the result, return a struct with ptr set to last and ec set to errc::value_too_large. Insufficient room in the output buffer is the only failure mode. The behavior is undefined unless first < last and base is in the range [ 2 .. 36 ].
a to_chars_result indicating success or failure and the end of the written representation
| Name | Description |
|---|---|
| first | beginning of the character buffer to write into |
| last | end of the character buffer to write into |
| value | integral value to convert to characters |
| base | numeric base for the conversion, in the range [2 .. 36] |