Skip to content

Commit eb383a2

Browse files
GirgiasGirgias
committed
PHP-8.4: Document fpow()
1 parent b6c220c commit eb383a2

File tree

4 files changed

+112
-2
lines changed

4 files changed

+112
-2
lines changed

‎reference/math/functions/fdiv.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -76,9 +76,9 @@ 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>
8079
<member><function>intdiv</function> - Integer division</member>
81-
<member><function>fmod</function> - Modulus</member>
80+
<member><function>fmod</function></member>
81+
<member><function>fpow</function></member>
8282
</simplelist>
8383
</para>
8484
</refsect1>

‎reference/math/functions/fpow.xml

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
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>num1</parameter> to the power of <parameter>exponent</parameter>.
18+
If <parameter>num1</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 number.
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><parameter>num</parameter><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(0, -3));
61+
var_dump(fpow(-1, 5.5));
62+
?>
63+
]]>
64+
</programlisting>
65+
&example.outputs;
66+
<screen>
67+
<![CDATA[
68+
float(INF)
69+
float(NAN)
70+
]]>
71+
</screen>
72+
</example>
73+
</refsect1>
74+
75+
<refsect1 role="seealso">
76+
&reftitle.seealso;
77+
<simplelist>
78+
<member><link linkend="language.operators.arithmetic"><literal>/</literal></link> - Floating-point division</member>
79+
<member><function>pow</function></member>
80+
<member><function>fdiv</function></member>
81+
<member><function>fmod</function></member>
82+
<!-- TODO ** operator link?
83+
<member><link linkend="some.id.chunk.to.link">something appendix</link></member>
84+
-->
85+
</simplelist>
86+
</refsect1>
87+
88+
</refentry>
89+
<!-- Keep this comment at the end of the file
90+
Local variables:
91+
mode: sgml
92+
sgml-omittag:t
93+
sgml-shorttag:t
94+
sgml-minimize-attributes:nil
95+
sgml-always-quote-attributes:t
96+
sgml-indent-step:1
97+
sgml-indent-data:t
98+
indent-tabs-mode:nil
99+
sgml-parent-document:nil
100+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
101+
sgml-exposed-tags:nil
102+
sgml-local-catalogs:nil
103+
sgml-local-ecat-files:nil
104+
End:
105+
vim600: syn=xml fen fdm=syntax fdl=2 si
106+
vim: et tw=78 syn=sgml
107+
vi: ts=1 sw=1
108+
-->

‎reference/math/functions/pow.xml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,7 @@ echo pow(-1, 5.5); // NAN
9595
&reftitle.seealso;
9696
<para>
9797
<simplelist>
98+
<member><function>fpow</function></member>
9899
<member><function>exp</function></member>
99100
<member><function>sqrt</function></member>
100101
<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)