[#BloombergLP-bdldfp-DecimalUtil-multiplyByPowerOf10-03]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::xref:BloombergLP/bdldfp/DecimalUtil.adoc[DecimalUtil]::multiplyByPowerOf10
:relfileprefix: ../../../
:mrdocs:

Return `value` multiplied by ten raised to `exponent`&period;

== Synopsis

Declared in `&lt;bdldfp&lowbar;decimalutil&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32]
multiplyByPowerOf10(
    xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32] value,
    int exponent);
----

== Description

Return the result of multiplying the specified `value` by ten raised to the specified `exponent`&period; The quantum of `value` is scaled according to IEEE 754&apos;s `scaleB` operations&period;

Special value handling&colon; &ast; If `value` is quiet NaN, quiet NaN is returned&period; &ast; If `value` is signaling NaN, quiet NaN is returned and the value of the macro `EDOM` is stored into `errno`&period; &ast; If `x` is infinite, then infinity is returned&period; &ast; If a range error due to overflow occurs, infinity is returned and&colon; the value of the macro `ERANGE` is stored into `errno`&period;

== Return Value

`value` multiplied by ten raised to `exponent`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *value*
| decimal value to scale
| *exponent*
| power of ten applied to `value`
|===


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