BloombergLP::bslalg::NumericFormatterUtil::toChars

Write the specified floating point value into the character buffer starting a 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.

Synopsis

Declared in <bslalg_numericformatterutil.h>

static
char*
toChars(
    char* first,
    char* last,
    double value,
    Format format) noexcept;