reference/math/functions/pow.xml
fc174e8d6162091550edde46159917ee7e5a2e73
fc174e8d6162091550edde46159917ee7e5a2e73
...
...
@@ -8,18 +8,17 @@
8
8
<refsect1 role="description">
9
9
&reftitle.description;
10
10
<methodsynopsis>
11
-
<type>number</type><methodname>pow</methodname>
12
-
<methodparam><type>number</type><parameter>base</parameter></methodparam>
13
-
<methodparam><type>number</type><parameter>exp</parameter></methodparam>
14
-
</methodsynopsis>
11
+
<type class="union"><type>int</type><type>float</type><type>object</type></type><methodname>pow</methodname>
12
+
<methodparam><type>mixed</type><parameter>num</parameter></methodparam>
13
+
<methodparam><type>mixed</type><parameter>exponent</parameter></methodparam>
14
+
</methodsynopsis>
15
15
<para>
16
-
Returns <parameter>base</parameter> raised to the power of
17
-
<parameter>exp</parameter>.
16
+
Returns <parameter>num</parameter> raised to the power of
17
+
<parameter>exponent</parameter>.
18
18
</para>
19
19
<note>
20
20
<para>
21
-
In PHP 5.6 onwards, you may prefer to use the
22
-
<link linkend="language.operators.arithmetic">**</link> operator.
21
+
It is possible to use the <link linkend="language.operators.arithmetic">**</link> operator instead.
23
22
</para>
24
23
</note>
25
24
</refsect1>
...
...
@@ -28,7 +27,7 @@
28
27
<para>
29
28
<variablelist>
30
29
<varlistentry>
31
-
<term><parameter>base</parameter></term>
30
+
<term><parameter>num</parameter></term>
32
31
<listitem>
33
32
<para>
34
33
The base to use
...
...
@@ -36,7 +35,7 @@
36
35
</listitem>
37
36
</varlistentry>
38
37
<varlistentry>
39
-
<term><parameter>exp</parameter></term>
38
+
<term><parameter>exponent</parameter></term>
40
39
<listitem>
41
40
<para>
42
41
The exponent
...
...
@@ -49,9 +48,9 @@
49
48
<refsect1 role="returnvalues">
50
49
&reftitle.returnvalues;
51
50
<para>
52
-
<parameter>base</parameter> raised to the power of <parameter>exp</parameter>.
51
+
<parameter>num</parameter> raised to the power of <parameter>exponent</parameter>.
53
52
If both arguments are non-negative integers and the result can be represented
54
-
as an integer, the result will be returned with <type>integer</type> type,
53
+
as an integer, the result will be returned with <type>int</type> type,
55
54
otherwise it will be returned as a <type>float</type>.
56
55
</para>
57
56
</refsect1>
...
...
@@ -69,8 +68,7 @@ echo pow(-1, 20); // 1
69
68
echo pow(0, 0); // 1
70
69
echo pow(10, -1); // 0.1
71
70
72
-
echo pow(-1, 5.5); // PHP >=5.2.2: NAN
73
-
echo pow(-1, 5.5); // PHP <5.2.2: -NAN
71
+
echo pow(-1, 5.5); // NAN
74
72
?>
75
73
]]>
76
74
</programlisting>
...
...
@@ -83,7 +81,7 @@ echo pow(-1, 5.5); // PHP <5.2.2: -NAN
83
81
<note>
84
82
<para>
85
83
This function will convert all input to a number, even non-scalar values,
86
-
which could lead to <literal>weird</literal> results.
84
+
which could lead to <emphasis>weird</emphasis> results.
87
85
</para>
88
86
</note>
89
87
</refsect1>
...
...
@@ -100,7 +98,6 @@ echo pow(-1, 5.5); // PHP <5.2.2: -NAN
100
98
</para>
101
99
</refsect1>
102
100
</refentry>
103
-
104
101
<!-- Keep this comment at the end of the file
105
102
Local variables:
106
103
mode: sgml
107
104