Compile-time rational arithmetic (since C++11)

From cppreference.com
Metaprogramming library
Type traits
Type categories
Type properties
(C++11)
(C++11)
(C++14)
(C++11) (deprecated in C++26)
(C++11) ( until C++20* )
(C++11) (deprecated in C++20)
(C++11)
Type trait constants
Metafunctions
(C++17)
Supported operations
Relationships and property queries
Type modifications
Type transformations
(C++11) (deprecated in C++23)
(C++11) (deprecated in C++23)
(C++11)
(C++11)
(C++17)

(C++11) ( until C++20* ) (C++17)
Compile-time rational arithmetic
Compile-time integer sequences
Compile time rational arithmetic

The class template std::ratio and associated templates provide compile-time rational arithmetic support. Each instantiation of this template exactly represents any finite rational number.

Compile-time fractions

Defined in header <ratio>
(C++11)
represents exact rational fraction
(class template)

The following convenience typedefs that correspond to the SI ratios are provided by the standard library:

Defined in header <ratio>
Type Definition
quecto (since C++26) std:: ratio < 1 , 1000000000000000000000000000000 > (10 -30 ) [1]
ronto (since C++26) std:: ratio < 1 , 1000000000000000000000000000 > (10 -27 ) [1]
yocto (since C++11) std:: ratio < 1 , 1000000000000000000000000 > (10 -24 ) [1]
zepto (since C++11) std:: ratio < 1 , 1000000000000000000000 > (10 -21 ) [1]
atto (since C++11) std:: ratio < 1 , 1000000000000000000 > (10 -18 )
femto (since C++11) std:: ratio < 1 , 1000000000000000 > (10 -15 )
pico (since C++11) std:: ratio < 1 , 1000000000000 > (10 -12 )
nano (since C++11) std:: ratio < 1 , 1000000000 > (10 -9 )
micro (since C++11) std:: ratio < 1 , 1000000 > (10 -6 )
milli (since C++11) std:: ratio < 1 , 1000 > (10 -3 )
centi (since C++11) std:: ratio < 1 , 100 > (10 -2 )
deci (since C++11) std:: ratio < 1 , 10 > (10 -1 )
deca (since C++11) std:: ratio < 10 , 1 > (10 1 )
hecto (since C++11) std:: ratio < 100 , 1 > (10 2 )
kilo (since C++11) std:: ratio < 1000 , 1 > (10 3 )
mega (since C++11) std:: ratio < 1000000 , 1 > (10 6 )
giga (since C++11) std:: ratio < 1000000000 , 1 > (10 9 )
tera (since C++11) std:: ratio < 1000000000000 , 1 > (10 12 )
peta (since C++11) std:: ratio < 1000000000000000 , 1 > (10 15 )
exa (since C++11) std:: ratio < 1000000000000000000 , 1 > (10 18 )
zetta (since C++11) std:: ratio < 1000000000000000000000 , 1 > (10 21 ) [2]
yotta (since C++11) std:: ratio < 1000000000000000000000000 , 1 > (10 24 ) [2]
ronna (since C++26) std:: ratio < 1000000000000000000000000000 , 1 > (10 27 ) [2]
quetta (since C++26) std:: ratio < 1000000000000000000000000000000 , 1 > (10 30 ) [2]
  1. 1.0 1.1 1.2 1.3 These typedefs are only declared if std::intmax_t can represent the denominator.
  2. 2.0 2.1 2.2 2.3 These typedefs are only declared if std::intmax_t can represent the numerator.

Compile-time rational arithmetic

Several alias templates, that perform arithmetic operations on ratio objects at compile-time are provided.

Defined in header <ratio>
(C++11)
adds two ratio objects at compile-time
(alias template)
subtracts two ratio objects at compile-time
(alias template)
multiplies two ratio objects at compile-time
(alias template)
divides two ratio objects at compile-time
(alias template)

Compile-time rational comparison

Several class templates, that perform comparison operations on ratio objects at compile-time are provided.

Defined in header <ratio>
compares two ratio objects for equality at compile-time
(class template)
compares two ratio objects for inequality at compile-time
(class template)
(C++11)
compares two ratio objects for less than at compile-time
(class template)
compares two ratio objects for less than or equal to at compile-time
(class template)
compares two ratio objects for greater than at compile-time
(class template)
compares two ratio objects for greater than or equal to at compile-time
(class template)