[#mp_units-power]
= xref:mp_units.adoc[mp_units]::power
:relfileprefix: ../
:mrdocs:

Type container for exponents with ratio different than `1`

== Synopsis

Declared in `<mp‐units/framework/symbolic_expression.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    /* implementation-defined */ F,
    int Num,
    int Den...>
requires (detail::valid_ratio<Num, Den...> && detail::positive_ratio<Num, Den...> && !detail::ratio_one<Num, Den...>)
struct power final
----

== Types

[cols=1]
|===
| Name
| xref:mp_units/power/_factor_.adoc[`_factor_`] 
|===

== Static Data Members

[cols=1]
|===
| Name
| xref:mp_units/power/_exponent_.adoc[`_exponent_`] 
|===

== Description

Ratio must be mathematically valid and non‐negative. Negative exponents are passed to `per<...>` with inverted sign (as positive exponents).

[NOTE]
====
`Den` is an optional parameter to shorten the types presented to the user in the case when `Den` equals `1`.

====

== Template Parameters

[cols=2]
|===
| Name
| Description
| *F*
| factor to be raised to specified power
| *Num*
| Power ratio numerator
| *Den*
| [optional]Power ration denominator
|===


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