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

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

== Synopsis

Declared in `<bdldfp_decimalimputil.h>`

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

== Return Value

the length of the formatted value

== Parameters

[cols="1,4"]
|===
| Name| Description
| *buffer*
| destination character buffer
| *length*
| capacity of `buffer` in characters
| *value*
| decimal value to format
| *cfg*
| formatting configuration
|===


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