[#BloombergLP-bdldfp-DecimalUtil-pow-04]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::xref:BloombergLP/bdldfp/DecimalUtil.adoc[DecimalUtil]::pow
:relfileprefix: ../../../
:mrdocs:

Return the value of the specified `base` raised to the power of the specified `exp`.

== Synopsis

Declared in `<bdldfp_decimalutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32]
pow(
    xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32] base,
    xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32] exp);
----

== Description

Special value handling: * If `base` is finite and negative and `exp` is finite and non‐integer, quiet NaN is returned and the value of the macro `EDOM` is stored into `errno`. * If the mathematical result of this function is infinity or undefined or a range error due to overflow occurs, infinity is returned and the value of the macro `ERANGE` is stored into `errno`. * If a range error occurs due to underflow, the correct result (after rounding) is returned and the value of the macro `ERANGE` is stored into `errno`. * If either argument is signaling NaN, quiet NaN is returned and the value of the macro `EDOM` is stored into `errno`.


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