-
Notifications
You must be signed in to change notification settings - Fork 731
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Closes GH-258. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@352017 c90b9560-bf6c-de11-be94-00142212c4b1
- Loading branch information
Showing
2 changed files
with
107 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,106 @@ | ||
<?xml version="1.0" encoding="utf-8"?> | ||
<!-- $Revision$ --> | ||
<refentry xml:id="function.fdiv" xmlns="http://docbook.org/ns/docbook"> | ||
<refnamediv> | ||
<refname>fdiv</refname> | ||
<refpurpose>Divides two numbers, according to IEEE 754</refpurpose> | ||
</refnamediv> | ||
<refsect1 role="description"> | ||
&reftitle.description; | ||
<methodsynopsis> | ||
<type>float</type><methodname>fdiv</methodname> | ||
<methodparam><type>float</type><parameter>dividend</parameter></methodparam> | ||
<methodparam><type>float</type><parameter>divisor</parameter></methodparam> | ||
</methodsynopsis> | ||
<para> | ||
Returns the floating point result of dividing the | ||
<parameter>dividend</parameter> by the <parameter>divisor</parameter>. | ||
If the <parameter>divisor</parameter> is zero, then one of <literal>INF</literal>, | ||
<literal>-INF</literal>, or <literal>NAN</literal> will be returned. | ||
</para> | ||
<para> | ||
Note that in comparisons, <literal>NAN</literal> will never <code>==</code> or <code>===</code>, | ||
any value, including itself. | ||
</para> | ||
</refsect1> | ||
<refsect1 role="parameters"> | ||
&reftitle.parameters; | ||
<para> | ||
<variablelist> | ||
<varlistentry> | ||
<term><parameter>dividend</parameter></term> | ||
<listitem> | ||
<para> | ||
The dividend (numerator) | ||
</para> | ||
</listitem> | ||
</varlistentry> | ||
<varlistentry> | ||
<term><parameter>divisor</parameter></term> | ||
<listitem> | ||
<para> | ||
The divisor | ||
</para> | ||
</listitem> | ||
</varlistentry> | ||
</variablelist> | ||
</para> | ||
</refsect1> | ||
<refsect1 role="returnvalues"> | ||
&reftitle.returnvalues; | ||
<para> | ||
The floating point result of | ||
<parameter>dividend</parameter>/<parameter>divisor</parameter> | ||
</para> | ||
</refsect1> | ||
<refsect1 role="examples"> | ||
&reftitle.examples; | ||
<para> | ||
<example> | ||
<title>Using <function>fdiv</function></title> | ||
<programlisting role="php"> | ||
<![CDATA[ | ||
<?php | ||
var_dump(fdiv(5.7, 1.3)); // float(4.384615384615385) | ||
var_dump(fdiv(4, 2)); // float(2) | ||
var_dump(fdiv(1.0, 0.0)); // float(INF) | ||
var_dump(fdiv(-1.0, 0.0)); // float(-INF) | ||
var_dump(fdiv(0.0, 0.0)); // float(NAN) | ||
?> | ||
]]> | ||
</programlisting> | ||
</example> | ||
</para> | ||
</refsect1> | ||
<refsect1 role="seealso"> | ||
&reftitle.seealso; | ||
<para> | ||
<simplelist> | ||
<member><link linkend="language.operators.arithmetic"><literal>/</literal></link> - Floating-point division</member> | ||
<member><function>intdiv</function> - Integer division</member> | ||
<member><function>fmod</function> - Modulus</member> | ||
</simplelist> | ||
</para> | ||
</refsect1> | ||
</refentry> | ||
|
||
<!-- Keep this comment at the end of the file | ||
Local variables: | ||
mode: sgml | ||
sgml-omittag:t | ||
sgml-shorttag:t | ||
sgml-minimize-attributes:nil | ||
sgml-always-quote-attributes:t | ||
sgml-indent-step:1 | ||
sgml-indent-data:t | ||
indent-tabs-mode:nil | ||
sgml-parent-document:nil | ||
sgml-default-dtd-file:"~/.phpdoc/manual.ced" | ||
sgml-exposed-tags:nil | ||
sgml-local-catalogs:nil | ||
sgml-local-ecat-files:nil | ||
End: | ||
vim600: syn=xml fen fdm=syntax fdl=2 si | ||
vim: et tw=78 syn=sgml | ||
vi: ts=1 sw=1 | ||
--> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters