Format floating-point value using the specified format.
Declared in <bslalg_numericformatterutil.h>
static
char*
toChars(
char* first,
char* last,
double value,
Format format) noexcept;Write the specified floating point value into the character buffer starting at the specified first and ending at the specified last, last not included, using the specified format with the {Shortest (Textual) Decimal Representation for Binary Floating Point Values} used in that format (that will produce the exact binary floating point value when converted back to the original type from text), but see possible exceptions under {Special Floating Point Values}. Return the address one past the last character (lowest order digit or last digit of the exponent) written on success, or 0 on failure. The only reason for failure is when the range [ first, last )] is not large enough to contain the result. The written result is to begin at first with leftover room following the return value. The behavior is undefined unless first <= last. Note that these functions do not null-terminate the result.
pointer past the last character written, or null on failure
| Name | Description |
|---|---|
| first | beginning of the output character range |
| last | end of the output character range |
| value | floating-point value to format |
| format | floating-point formatting style |