Skip to content

Commit 2b7eeba

Browse files
Girgiascmb69
Girgias
and
cmb69
authored
PHP-8.4: Document fpow() (#4035)
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
1 parent 8a9f4bd commit 2b7eeba

File tree

4 files changed

+122
-2
lines changed

4 files changed

+122
-2
lines changed

‎reference/math/functions/fdiv.xml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -76,9 +76,13 @@ var_dump(fdiv(0.0, 0.0)); // float(NAN)
7676
&reftitle.seealso;
7777
<para>
7878
<simplelist>
79-
<member><link linkend="language.operators.arithmetic"><literal>/</literal></link> - Floating-point division</member>
79+
<member>
80+
Division operator
81+
<link linkend="language.operators.arithmetic"><literal>/</literal></link>
82+
</member>
8083
<member><function>intdiv</function> - Integer division</member>
81-
<member><function>fmod</function> - Modulus</member>
84+
<member><function>fmod</function></member>
85+
<member><function>fpow</function></member>
8286
</simplelist>
8387
</para>
8488
</refsect1>

‎reference/math/functions/fpow.xml

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<refentry xml:id="function.fpow" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<refnamediv>
4+
<refname>fpow</refname>
5+
<refpurpose>Raise one number to the power of another, according to IEEE 754</refpurpose>
6+
</refnamediv>
7+
8+
<refsect1 role="description">
9+
&reftitle.description;
10+
<methodsynopsis>
11+
<type>float</type><methodname>fpow</methodname>
12+
<methodparam><type>float</type><parameter>num</parameter></methodparam>
13+
<methodparam><type>float</type><parameter>exponent</parameter></methodparam>
14+
</methodsynopsis>
15+
<simpara>
16+
Returns the floating point result of raising
17+
<parameter>num</parameter> to the power of <parameter>exponent</parameter>.
18+
If <parameter>num</parameter> is zero and <parameter>exponent</parameter>
19+
is less than zero, then <constant>INF</constant> is returned.
20+
</simpara>
21+
</refsect1>
22+
23+
<refsect1 role="parameters">
24+
&reftitle.parameters;
25+
<variablelist>
26+
<varlistentry>
27+
<term><parameter>num</parameter></term>
28+
<listitem>
29+
<simpara>
30+
The base to use.
31+
</simpara>
32+
</listitem>
33+
</varlistentry>
34+
<varlistentry>
35+
<term><parameter>exponent</parameter></term>
36+
<listitem>
37+
<simpara>
38+
The exponent.
39+
</simpara>
40+
</listitem>
41+
</varlistentry>
42+
</variablelist>
43+
</refsect1>
44+
45+
<refsect1 role="returnvalues">
46+
&reftitle.returnvalues;
47+
<simpara>
48+
Returns a <type>float</type> corresponding to
49+
<code>$num<superscript>$exponent</superscript></code>.
50+
</simpara>
51+
</refsect1>
52+
53+
<refsect1 role="examples">
54+
&reftitle.examples;
55+
<example xml:id="function.fpow.example.basic">
56+
<title><function>fpow</function> example</title>
57+
<programlisting role="php">
58+
<![CDATA[
59+
<?php
60+
var_dump(fpow(10, 2));
61+
var_dump(fpow(0, -3));
62+
var_dump(fpow(-1, 5.5));
63+
?>
64+
]]>
65+
</programlisting>
66+
&example.outputs;
67+
<screen>
68+
<![CDATA[
69+
float(100)
70+
float(INF)
71+
float(NAN)
72+
]]>
73+
</screen>
74+
</example>
75+
</refsect1>
76+
77+
<refsect1 role="seealso">
78+
&reftitle.seealso;
79+
<simplelist>
80+
<member>
81+
Exponentiation operator
82+
<link linkend="language.operators.arithmetic"><literal>**</literal></link>
83+
</member>
84+
<member><function>pow</function></member>
85+
<member><function>fdiv</function></member>
86+
<member><function>fmod</function></member>
87+
</simplelist>
88+
</refsect1>
89+
90+
</refentry>
91+
<!-- Keep this comment at the end of the file
92+
Local variables:
93+
mode: sgml
94+
sgml-omittag:t
95+
sgml-shorttag:t
96+
sgml-minimize-attributes:nil
97+
sgml-always-quote-attributes:t
98+
sgml-indent-step:1
99+
sgml-indent-data:t
100+
indent-tabs-mode:nil
101+
sgml-parent-document:nil
102+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
103+
sgml-exposed-tags:nil
104+
sgml-local-catalogs:nil
105+
sgml-local-ecat-files:nil
106+
End:
107+
vim600: syn=xml fen fdm=syntax fdl=2 si
108+
vim: et tw=78 syn=sgml
109+
vi: ts=1 sw=1
110+
-->

‎reference/math/functions/pow.xml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,11 @@ echo pow(-1, 5.5); // NAN
9595
&reftitle.seealso;
9696
<para>
9797
<simplelist>
98+
<member>
99+
Exponentiation operator
100+
<link linkend="language.operators.arithmetic"><literal>**</literal></link>
101+
</member>
102+
<member><function>fpow</function></member>
98103
<member><function>exp</function></member>
99104
<member><function>sqrt</function></member>
100105
<member><function>bcpow</function></member>

‎reference/math/versions.xml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@
2626
<function name="fdiv" from="PHP 8"/>
2727
<function name="floor" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
2828
<function name="fmod" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
29+
<function name="fpow" from="PHP 8 &gt;= 8.4.0"/>
2930
<function name="hexdec" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
3031
<function name="hypot" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
3132
<function name="is_finite" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>

0 commit comments

Comments
 (0)