File: Small-integer-powers.html

package info (click to toggle)
gsl-ref-html 2.3-1
  • links: PTS
  • area: non-free
  • in suites: bullseye, buster, sid
  • size: 6,876 kB
  • ctags: 4,574
  • sloc: makefile: 35
file content (113 lines) | stat: -rw-r--r-- 6,204 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".

(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library &ndash; Reference Manual: Small integer powers</title>

<meta name="description" content="GNU Scientific Library &ndash; Reference Manual: Small integer powers">
<meta name="keywords" content="GNU Scientific Library &ndash; Reference Manual: Small integer powers">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="Mathematical-Functions.html#Mathematical-Functions" rel="up" title="Mathematical Functions">
<link href="Testing-the-Sign-of-Numbers.html#Testing-the-Sign-of-Numbers" rel="next" title="Testing the Sign of Numbers">
<link href="Elementary-Functions.html#Elementary-Functions" rel="previous" title="Elementary Functions">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Small-integer-powers"></a>
<div class="header">
<p>
Next: <a href="Testing-the-Sign-of-Numbers.html#Testing-the-Sign-of-Numbers" accesskey="n" rel="next">Testing the Sign of Numbers</a>, Previous: <a href="Elementary-Functions.html#Elementary-Functions" accesskey="p" rel="previous">Elementary Functions</a>, Up: <a href="Mathematical-Functions.html#Mathematical-Functions" accesskey="u" rel="up">Mathematical Functions</a> &nbsp; [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Small-integer-powers-1"></a>
<h3 class="section">4.4 Small integer powers</h3>

<p>A common complaint about the standard C library is its lack of a
function for calculating (small) integer powers.  GSL provides some simple
functions to fill this gap.  For reasons of efficiency, these functions
do not check for overflow or underflow conditions. 
</p>
<dl>
<dt><a name="index-gsl_005fpow_005fint"></a>Function: <em>double</em> <strong>gsl_pow_int</strong> <em>(double <var>x</var>, int <var>n</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005fuint"></a>Function: <em>double</em> <strong>gsl_pow_uint</strong> <em>(double <var>x</var>, unsigned int <var>n</var>)</em></dt>
<dd><p>These routines computes the power <em>x^n</em> for integer <var>n</var>.  The
power is computed efficiently&mdash;for example, <em>x^8</em> is computed as
<em>((x^2)^2)^2</em>, requiring only 3 multiplications.  A version of this
function which also computes the numerical error in the result is
available as <code>gsl_sf_pow_int_e</code>.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fpow_005f2"></a>Function: <em>double</em> <strong>gsl_pow_2</strong> <em>(const double <var>x</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005f3"></a>Function: <em>double</em> <strong>gsl_pow_3</strong> <em>(const double <var>x</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005f4"></a>Function: <em>double</em> <strong>gsl_pow_4</strong> <em>(const double <var>x</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005f5"></a>Function: <em>double</em> <strong>gsl_pow_5</strong> <em>(const double <var>x</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005f6"></a>Function: <em>double</em> <strong>gsl_pow_6</strong> <em>(const double <var>x</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005f7"></a>Function: <em>double</em> <strong>gsl_pow_7</strong> <em>(const double <var>x</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005f8"></a>Function: <em>double</em> <strong>gsl_pow_8</strong> <em>(const double <var>x</var>)</em></dt>
<dt><a name="index-gsl_005fpow_005f9"></a>Function: <em>double</em> <strong>gsl_pow_9</strong> <em>(const double <var>x</var>)</em></dt>
<dd><p>These functions can be used to compute small integer powers <em>x^2</em>,
<em>x^3</em>, etc. efficiently. The functions will be inlined when 
<code>HAVE_INLINE</code> is defined, so that use of these functions 
should be as efficient as explicitly writing the corresponding 
product expression.
</p></dd></dl>

<div class="example">
<pre class="example">#include &lt;gsl/gsl_math.h&gt;
double y = gsl_pow_4 (3.141)  /* compute 3.141**4 */
</pre></div>




</body>
</html>