[#BloombergLP-bdldfp-DecimalImpUtil-format-0c]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::xref:BloombergLP/bdldfp/DecimalImpUtil.adoc[DecimalImpUtil]::format
:relfileprefix: ../../../
:mrdocs:

`format` overloads

== Synopses

Declared in `<bdldfp_decimalimputil.h>`

Format the specified `value`, according to the parameters in the specified `cfg`. Place the output in the buffer designated by the specified `buffer` and `length`, and return the length of the formatted value. If there is insufficient room in the buffer, its contents will be left in an unspecified state, with the returned value indicating the necessary size. This function does not write a terminating null character. If `length` is not positive, `buffer` is permitted to be null. This can be used to determine the necessary buffer size. See the  section for information on the configuration attributes.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdldfp/DecimalImpUtil/format-0e.adoc[format](
    char* buffer,
    int length,
    xref:BloombergLP/bdldfp/DecimalImpUtil/ValueType128.adoc[ValueType128] value,
    xref:BloombergLP/bdldfp/DecimalFormatConfig.adoc[DecimalFormatConfig] const& cfg);
----

[.small]#xref:BloombergLP/bdldfp/DecimalImpUtil/format-0e.adoc[_» more..._]#

Format the specified `ValueType64` using the specified configuration. Format the specified decimal `value` into `buffer`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdldfp/DecimalImpUtil/format-08.adoc[format](
    char* buffer,
    int length,
    xref:BloombergLP/bdldfp/DecimalImpUtil/ValueType32.adoc[ValueType32] value,
    xref:BloombergLP/bdldfp/DecimalFormatConfig.adoc[DecimalFormatConfig] const& cfg);
----

[.small]#xref:BloombergLP/bdldfp/DecimalImpUtil/format-08.adoc[_» more..._]#

Format the specified `value` into `buffer` using the specified `cfg`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdldfp/DecimalImpUtil/format-0f.adoc[format](
    char* buffer,
    int length,
    xref:BloombergLP/bdldfp/DecimalImpUtil/ValueType64.adoc[ValueType64] value,
    xref:BloombergLP/bdldfp/DecimalFormatConfig.adoc[DecimalFormatConfig] const& cfg);
----

[.small]#xref:BloombergLP/bdldfp/DecimalImpUtil/format-0f.adoc[_» more..._]#


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