<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.types.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'language.types.float.php',
    1 => '浮動小数点数',
    2 => '浮動小数点数',
  ),
  'up' => 
  array (
    0 => 'language.types.php',
    1 => '型',
  ),
  'prev' => 
  array (
    0 => 'language.types.integer.php',
    1 => '整数',
  ),
  'next' => 
  array (
    0 => 'language.types.string.php',
    1 => '文字列',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'language/types/float.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.types.float" class="sect1">
 <h2 class="title">浮動小数点数</h2>

 <p class="para">
  浮動小数点数 (あるいは &quot;float&quot;, &quot;double&quot;, &quot;実数&quot;) は、次の構文により指定できます。
 </p>

 <div class="informalexample">
  <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1.234</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">1.2e3</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= </span><span style="color: #0000BB">7E-10</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$d </span><span style="color: #007700">= </span><span style="color: #0000BB">1_234.567</span><span style="color: #007700">; </span><span style="color: #FF8000">// PHP 7.4.0 以降<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>

 <p class="para">
  PHP 7.4.0 以降の規約(これより前のバージョンでは、アンダースコアは許されませんでした):
 </p>

 <div class="informalexample">
  <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
LNUM          [0-9]+(_[0-9]+)*
DNUM          ({LNUM}?&quot;.&quot;{LNUM}) | ({LNUM}&quot;.&quot;{LNUM}?)
EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
</pre></div>
  </div>

 </div>

 <p class="para">
  float の大きさはプラットフォーム依存です。ただし、通常はおよそ 10
  進数で 14 桁の精度があり、最大値は およそ 1.8e308 (これは 64ビット IEEE
  フォーマットです) となります。
 </p>

 <div class="warning"><strong class="warning">警告</strong>
  <h1 class="title">浮動小数点数の精度</h1>

  <p class="para">
   浮動小数点数の精度は有限です。
   システムに依存しますが、PHP は通常 IEEE 754 倍精度フォーマットを使います。
   この形式は、1.11e-16 のオーダーでの丸め処理で誤差が発生します。
   複雑な算術演算をすると、誤差はさらに大きくなるでしょう。そしてもちろん、
   いくつかの演算を組み合わせる場合にも誤差を考慮しなければなりません。
  </p>

  <p class="para">
   さらに、十進数では正確な小数で表せる有理数、たとえば
   <code class="literal">0.1</code> や <code class="literal">0.7</code> は、
   二進数の浮動小数点数としては正確に表現できません。
   これは、仮数部をいくら大きくしても同じです。
   したがって、それを内部的な二進数表現に変換する際には、どうしても多少精度が落ちてしまいます。
   その結果、不思議な結果を引き起こすことがあります。たとえば、
   <code class="literal">floor((0.1+0.7)*10)</code> の結果はたいてい
   <code class="literal">7</code> となるでしょう。おそらくは
   <code class="literal">8</code> を想定していらっしゃるでしょうが、そのようにはなりません。
   これは、(この計算結果の) 内部的な値が
   <code class="literal">7.9999999999999991118...</code> のようになっているからです。
  </p>

  <p class="para">
   よって、小数の最後の桁を信用してはいけませんし、
   小数を直接比較して等しいかどうかを調べてはいけません。より高い精度が必要な場合には、
   <a href="ref.bc.php" class="link">任意精度数学関数</a>または
   <a href="ref.gmp.php" class="link">gmp</a> 関数を代わりに使用してください。
  </p>
  
  <p class="para">
   もっと「シンプルな」説明が欲しければ、<a href="http://floating-point-gui.de/" class="link external">&raquo;&nbsp;floating point guide</a>
   を見るといいでしょう。&quot;Why don’t my numbers add up? (なんで数字が足されないの?)&quot; というタイトルが付いています。
  </p>
 </div>

 <div class="sect2" id="language.types.float.casting">
  <h3 class="title">float への変換</h3>

  <div class="sect3" id="language.types.float.casting.from-string">
   <h4 class="title">文字列から float への変換</h4>

   <p class="simpara">
    文字列が
    <a href="language.types.numeric-strings.php" class="link">数値形式の文字列</a>
    の場合、対応する float の値に解決されます。
    そうでない場合、ゼロ(<code class="literal">0</code>)に変換されます。
   </p>
  </div>

  <div class="sect3" id="language.types.float.casting.from-other">
   <h4 class="title">他の型から float への変換</h4>

   <p class="para">
    文字列以外の値については、
    まず最初に <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> に変換された後、
    <span class="type"><a href="language.types.float.php" class="type float">float</a></span> に変換されます。
    詳細は
    <a href="language.types.integer.php#language.types.integer.casting" class="link">整数への変換</a>
    を参照ください。
   </p>

   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     型によっては、<span class="type"><a href="language.types.integer.php" class="type int">int</a></span> に変換したときの動作が未定義のものがあります。
     この場合、<span class="type"><a href="language.types.float.php" class="type float">float</a></span> に変換する場合の動作も未定義です。
    </p>
   </p></blockquote>
  </div>

 </div>

 <div class="sect2" id="language.types.float.comparison">
  <h3 class="title">float の比較</h3>

  <p class="para">
   先ほど警告したように、浮動小数点数値が等しいかどうかを比較するのには問題があります。
   これは、浮動小数点数値の内部表現形式に起因するものです。
   しかし、この制限を回避して浮動小数点数値の値を比較する方法もあります。
  </p>

  <p class="para">
   浮動小数点数値が等しいかどうかを調べるには、比較時の丸め誤差の上界を用います。
   この値は計算機イプシロンあるいは丸め単位と呼ばれ、
   計算時に扱える最小の差分を表します。
  </p>
  
  <p class="para">
   <var class="varname">$a</var> と <var class="varname">$b</var> は、精度 5 桁では等しくなります。
  </p>

  <div class="example" id="example-1">
   <p><strong>例1 浮動小数点数の比較</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1.23456789</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">1.23456780</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$epsilon </span><span style="color: #007700">= </span><span style="color: #0000BB">0.00001</span><span style="color: #007700">;<br /><br />if (</span><span style="color: #0000BB">abs</span><span style="color: #007700">(</span><span style="color: #0000BB">$a </span><span style="color: #007700">- </span><span style="color: #0000BB">$b</span><span style="color: #007700">) &lt; </span><span style="color: #0000BB">$epsilon</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"true"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>

 <div class="sect2" id="language.types.float.nan">
  <h3 class="title">NaN</h3>
  <p class="para">
   数値演算の結果が、定数 <strong><code><a href="math.constants.php#constant.nan">NAN</a></code></strong> で表される値になることがあります。
   この定数は、浮動小数点演算における未定義の値あるいは表現不能な値を表します。
   この値を他の値と比較すると、緩やかな比較および厳密な比較のいずれでも結果は <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> になります。
   自分自身と比較した場合も含みますが、<strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> と比較した場合は除きます。
  </p>
  <p class="para">
   <strong><code><a href="math.constants.php#constant.nan">NAN</a></code></strong> はさまざまな値の数を表すものなので、
   <strong><code><a href="math.constants.php#constant.nan">NAN</a></code></strong> を他の値と比較してはいけません。たとえ自分自身とであってもです。
   チェックをする場合には、かわりに <span class="function"><a href="function.is-nan.php" class="function">is_nan()</a></span> を使います。
  </p>
 </div>
</div><?php manual_footer($setup); ?>