[#BloombergLP-bslalg-NumericFormatterUtil-toChars-007]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/NumericFormatterUtil.adoc[NumericFormatterUtil]::toChars
:relfileprefix: ../../../
:mrdocs:

included. If the optionally specified `base`argument is not present base 10 is used. 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`, and `base` is in the range `[ 2 .. 36 ]`. Note that the type `bool` for the `value` parameter is explicitly disabled in the "NOT IMPLEMENTED" `private` section, because `bool` would otherwise be promoted to `int` and printed as `0` or `1`, instead of the (possibly) expected `false` and `true`; and `bool` is not an integral or numeric type either. Also note that these functions do *not* null‐terminate the result. Format the specified character `value` into `[first, last)]`.

== Synopsis

Declared in `<bslalg_numericformatterutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
toChars(
    char* first,
    char* last,
    char value,
    int base = 10) noexcept;
----


[.small]#Created with https://www.mrdocs.com[MrDocs]#