xref: /netbsd-src/external/lgpl3/gmp/dist/mpf/pow_ui.c (revision 72c7faa4dbb41dbb0238d6b4a109da0d4b236dd4)
1 /* mpf_pow_ui -- Compute b^e.
2 
3 Copyright 1998, 1999, 2001, 2012, 2015 Free Software Foundation, Inc.
4 
5 This file is part of the GNU MP Library.
6 
7 The GNU MP Library is free software; you can redistribute it and/or modify
8 it under the terms of either:
9 
10   * the GNU Lesser General Public License as published by the Free
11     Software Foundation; either version 3 of the License, or (at your
12     option) any later version.
13 
14 or
15 
16   * the GNU General Public License as published by the Free Software
17     Foundation; either version 2 of the License, or (at your option) any
18     later version.
19 
20 or both in parallel, as here.
21 
22 The GNU MP Library is distributed in the hope that it will be useful, but
23 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
24 or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
25 for more details.
26 
27 You should have received copies of the GNU General Public License and the
28 GNU Lesser General Public License along with the GNU MP Library.  If not,
29 see https://www.gnu.org/licenses/.  */
30 
31 #include "gmp-impl.h"
32 #include "longlong.h"
33 
34 /* This uses a plain right-to-left square-and-multiply algorithm.
35 
36    FIXME: When popcount(e) is not too small, it would probably speed things up
37    to use a k-ary sliding window algorithm.  */
38 
39 void
mpf_pow_ui(mpf_ptr r,mpf_srcptr b,unsigned long int e)40 mpf_pow_ui (mpf_ptr r, mpf_srcptr b, unsigned long int e)
41 {
42   mpf_t t;
43   int cnt;
44 
45   if (e <= 1)
46     {
47       if (e == 0)
48 	mpf_set_ui (r, 1);
49       else
50 	mpf_set (r, b);
51       return;
52     }
53 
54   count_leading_zeros (cnt, (mp_limb_t) e);
55   cnt = GMP_LIMB_BITS - 1 - cnt;
56 
57   /* Increase computation precision as a function of the exponent.  Adding
58      log2(popcount(e) + log2(e)) bits should be sufficient, but we add log2(e),
59      i.e. much more.  With mpf's rounding of precision to whole limbs, this
60      will be excessive only when limbs are artificially small.  */
61   mpf_init2 (t, mpf_get_prec (r) + cnt);
62 
63   mpf_set (t, b);		/* consume most significant bit */
64   while (--cnt > 0)
65     {
66       mpf_mul (t, t, t);
67       if ((e >> cnt) & 1)
68 	mpf_mul (t, t, b);
69     }
70 
71   /* Do the last iteration specially in order to save a copy operation.  */
72   if (e & 1)
73     {
74       mpf_mul (t, t, t);
75       mpf_mul (r, t, b);
76     }
77   else
78     {
79       mpf_mul (r, t, t);
80     }
81 
82   mpf_clear (t);
83 }
84