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

`toChars` overloads

== Synopses

Declared in `<bslalg_numericformatterutil.h>`

Format floating‐point `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0c.adoc[toChars](
    char* first,
    char* last,
    double value) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0c.adoc[_» more..._]#

Format floating‐point `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-05b.adoc[toChars](
    char* first,
    char* last,
    float value) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-05b.adoc[_» more..._]#

Format the specified character `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-007.adoc[toChars](
    char* first,
    char* last,
    char value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-007.adoc[_» more..._]#

Format floating‐point `value` using the specified `format`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-01.adoc[toChars](
    char* first,
    char* last,
    double value,
    xref:BloombergLP/bslalg/NumericFormatterUtil/Format.adoc[Format] format) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-01.adoc[_» more..._]#

Format floating‐point `value` using the specified `format`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-04.adoc[toChars](
    char* first,
    char* last,
    float value,
    xref:BloombergLP/bslalg/NumericFormatterUtil/Format.adoc[Format] format) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-04.adoc[_» more..._]#

Format the specified signed integer `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-03.adoc[toChars](
    char* first,
    char* last,
    int value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-03.adoc[_» more..._]#

Format the specified signed long integer `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-005.adoc[toChars](
    char* first,
    char* last,
    long value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-005.adoc[_» more..._]#

Format `value` in the specified `base` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-08.adoc[toChars](
    char* first,
    char* last,
    long long value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-08.adoc[_» more..._]#

Format the specified signed short integer `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0a1.adoc[toChars](
    char* first,
    char* last,
    short value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0a1.adoc[_» more..._]#

Format the specified signed character `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0f.adoc[toChars](
    char* first,
    char* last,
    signed char value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0f.adoc[_» more..._]#

Format the specified unsigned character `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0b.adoc[toChars](
    char* first,
    char* last,
    unsigned char value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0b.adoc[_» more..._]#

Format the specified unsigned integer `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0d1.adoc[toChars](
    char* first,
    char* last,
    unsigned int value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0d1.adoc[_» more..._]#

Format the specified unsigned long integer `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-068.adoc[toChars](
    char* first,
    char* last,
    unsigned long value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-068.adoc[_» more..._]#

Format the specified unsigned long long integer `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-058.adoc[toChars](
    char* first,
    char* last,
    unsigned long long value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-058.adoc[_» more..._]#

Format the specified integer `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-069.adoc[toChars](
    char* first,
    char* last,
    unsigned short value,
    int base = 10) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-069.adoc[_» more..._]#

Format floating‐point `value` using `format` and `precision`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0d7.adoc[toChars](
    char* first,
    char* last,
    double value,
    xref:BloombergLP/bslalg/NumericFormatterUtil/Format.adoc[Format] format,
    int precision) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0d7.adoc[_» more..._]#

Format the specified `float` `value` into `[first, last)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
char*
xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0aa.adoc[toChars](
    char* first,
    char* last,
    float value,
    xref:BloombergLP/bslalg/NumericFormatterUtil/Format.adoc[Format] format,
    int precision) noexcept;
----

[.small]#xref:BloombergLP/bslalg/NumericFormatterUtil/toChars-0aa.adoc[_» more..._]#

== Return Value

pointer past the last character written, or null on failure

== Parameters

[cols="1,4"]
|===
| Name| Description
| *first*
| beginning of the output character range
| *last*
| end of the output character range
| *value*
| floating‐point value to format
| *base*
| numeric base for formatting
| *format*
| floating‐point formatting style
| *precision*
| number of digits after the radix point
|===


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