1<html> 2<head> 3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 4<title>Rational Number Types</title> 5<link rel="stylesheet" href="../../multiprecision.css" type="text/css"> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="../../index.html" title="Chapter 1. Boost.Multiprecision"> 8<link rel="up" href="../tut.html" title="Tutorial"> 9<link rel="prev" href="complex/complex_adaptor.html" title="complex_adaptor"> 10<link rel="next" href="rational/cpp_rational.html" title="cpp_rational"> 11</head> 12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 13<table cellpadding="2" width="100%"><tr> 14<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td> 15<td align="center"><a href="../../../../../../index.html">Home</a></td> 16<td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td> 17<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 18<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 19<td align="center"><a href="../../../../../../more/index.htm">More</a></td> 20</tr></table> 21<hr> 22<div class="spirit-nav"> 23<a accesskey="p" href="complex/complex_adaptor.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="rational/cpp_rational.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a> 24</div> 25<div class="section"> 26<div class="titlepage"><div><div><h3 class="title"> 27<a name="boost_multiprecision.tut.rational"></a><a class="link" href="rational.html" title="Rational Number Types">Rational Number Types</a> 28</h3></div></div></div> 29<div class="toc"><dl class="toc"> 30<dt><span class="section"><a href="rational/cpp_rational.html">cpp_rational</a></span></dt> 31<dt><span class="section"><a href="rational/gmp_rational.html">gmp_rational</a></span></dt> 32<dt><span class="section"><a href="rational/tommath_rational.html">tommath_rational</a></span></dt> 33<dt><span class="section"><a href="rational/br.html">Use With Boost.Rational</a></span></dt> 34<dt><span class="section"><a href="rational/rational_adaptor.html">rational_adaptor</a></span></dt> 35</dl></div> 36<p> 37 The following back-ends provide rational number arithmetic: 38 </p> 39<div class="informaltable"><table class="table"> 40<colgroup> 41<col> 42<col> 43<col> 44<col> 45<col> 46<col> 47</colgroup> 48<thead><tr> 49<th> 50 <p> 51 Backend Type 52 </p> 53 </th> 54<th> 55 <p> 56 Header 57 </p> 58 </th> 59<th> 60 <p> 61 Radix 62 </p> 63 </th> 64<th> 65 <p> 66 Dependencies 67 </p> 68 </th> 69<th> 70 <p> 71 Pros 72 </p> 73 </th> 74<th> 75 <p> 76 Cons 77 </p> 78 </th> 79</tr></thead> 80<tbody> 81<tr> 82<td> 83 <p> 84 <code class="computeroutput"><span class="identifier">cpp_rational</span></code> 85 </p> 86 </td> 87<td> 88 <p> 89 boost/multiprecision/cpp_int.hpp 90 </p> 91 </td> 92<td> 93 <p> 94 2 95 </p> 96 </td> 97<td> 98 <p> 99 None 100 </p> 101 </td> 102<td> 103 <p> 104 An all C++ Boost-licensed implementation. 105 </p> 106 </td> 107<td> 108 <p> 109 Slower than <a href="http://gmplib.org" target="_top">GMP</a>. 110 </p> 111 </td> 112</tr> 113<tr> 114<td> 115 <p> 116 <code class="computeroutput"><span class="identifier">gmp_rational</span></code> 117 </p> 118 </td> 119<td> 120 <p> 121 boost/multiprecision/gmp.hpp 122 </p> 123 </td> 124<td> 125 <p> 126 2 127 </p> 128 </td> 129<td> 130 <p> 131 <a href="http://gmplib.org" target="_top">GMP</a> 132 </p> 133 </td> 134<td> 135 <p> 136 Very fast and efficient back-end. 137 </p> 138 </td> 139<td> 140 <p> 141 Dependency on GNU licensed <a href="http://gmplib.org" target="_top">GMP</a> 142 library. 143 </p> 144 </td> 145</tr> 146<tr> 147<td> 148 <p> 149 <code class="computeroutput"><span class="identifier">tommath_rational</span></code> 150 </p> 151 </td> 152<td> 153 <p> 154 boost/multiprecision/tommath.hpp 155 </p> 156 </td> 157<td> 158 <p> 159 2 160 </p> 161 </td> 162<td> 163 <p> 164 <a href="http://libtom.net" target="_top">libtommath</a> 165 </p> 166 </td> 167<td> 168 <p> 169 All C/C++ implementation that's Boost Software Licence compatible. 170 </p> 171 </td> 172<td> 173 <p> 174 Slower than <a href="http://gmplib.org" target="_top">GMP</a>. 175 </p> 176 </td> 177</tr> 178<tr> 179<td> 180 <p> 181 <code class="computeroutput"><span class="identifier">rational_adaptor</span></code> 182 </p> 183 </td> 184<td> 185 <p> 186 boost/multiprecision/rational_adaptor.hpp 187 </p> 188 </td> 189<td> 190 <p> 191 N/A 192 </p> 193 </td> 194<td> 195 <p> 196 none 197 </p> 198 </td> 199<td> 200 <p> 201 All C++ adaptor that allows any integer back-end type to be used 202 as a rational type. 203 </p> 204 </td> 205<td> 206 <p> 207 Requires an underlying integer back-end type. 208 </p> 209 </td> 210</tr> 211<tr> 212<td> 213 <p> 214 <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">rational</span></code> 215 </p> 216 </td> 217<td> 218 <p> 219 boost/rational.hpp 220 </p> 221 </td> 222<td> 223 <p> 224 N/A 225 </p> 226 </td> 227<td> 228 <p> 229 None 230 </p> 231 </td> 232<td> 233 <p> 234 A C++ rational number type that can used with any <code class="computeroutput"><span class="identifier">number</span></code> integer type. 235 </p> 236 </td> 237<td> 238 <p> 239 The expression templates used by <code class="computeroutput"><span class="identifier">number</span></code> 240 end up being "hidden" inside <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">rational</span></code>: 241 performance may well suffer as a result. 242 </p> 243 </td> 244</tr> 245</tbody> 246</table></div> 247</div> 248<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 249<td align="left"></td> 250<td align="right"><div class="copyright-footer">Copyright © 2002-2020 John 251 Maddock and Christopher Kormanyos<p> 252 Distributed under the Boost Software License, Version 1.0. (See accompanying 253 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) 254 </p> 255</div></td> 256</tr></table> 257<hr> 258<div class="spirit-nav"> 259<a accesskey="p" href="complex/complex_adaptor.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="rational/cpp_rational.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a> 260</div> 261</body> 262</html> 263