svn: /phpdoc/ja/trunk/reference/math/functions/ fdiv.xml

mumumu                                   Sat, 12 Dec 2020 02:38:12 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=352020

Log:
Add fdiv()

Closes GH-258.

Changed paths:
    A   phpdoc/ja/trunk/reference/math/functions/fdiv.xml

Added: phpdoc/ja/trunk/reference/math/functions/fdiv.xml
===================================================================
--- phpdoc/ja/trunk/reference/math/functions/fdiv.xml	                        (rev 0)
+++ phpdoc/ja/trunk/reference/math/functions/fdiv.xml	2020-12-12 02:38:12 UTC (rev 352020)
@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 352017 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="function.fdiv" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>fdiv</refname>
+  <refpurpose>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>
+   <parameter>dividend</parameter> を <parameter>divisor</parameter>
+   で割った結果を浮動小数点数の結果として返します。
+   <parameter>divisor</parameter> が 0 の場合、
+   <literal>INF</literal>,
+   <literal>-INF</literal>,
+   <literal>NAN</literal> のうちのいずれかを返します。
+  </para>
+  <para>
+   <literal>NAN</literal> は
+   <code>==</code> や <code>===</code> を使ってもいかなる値とも比較できないことに注意して下さい。
+   <literal>NAN</literal> のみが比較できます。
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>dividend</parameter></term>
+     <listitem>
+      <para>
+       被除数(分子)
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>divisor</parameter></term>
+     <listitem>
+      <para>
+       除数
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <parameter>dividend</parameter>/<parameter>divisor</parameter> の結果を浮動小数点数として返します。
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><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> - 浮動小数点数の除算</member>
+    <member><function>intdiv</function> - 整数値の除算</member>
+    <member><function>fmod</function> - 剰余</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
+-->


Property changes on: phpdoc/ja/trunk/reference/math/functions/fdiv.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property