archived-doc-zh/reference/math/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 98a193dab55c7c7258c94312297fbe5a1e4c397f Maintainer: yincheng Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<appendix xml:id="math.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants.core;
 <!-- TODO: Use MathML the moment PhD supports it -->
 <variablelist>
  <title>数学常量</title>
  <varlistentry xml:id="constant.m-pi">
   <term>
    <constant>M_PI</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     π（圆周率）的近似值（<literal>3.14159265358979323846</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-e">
   <term>
    <constant>M_E</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     自然常数 <literal>e</literal>的近似值（<literal>2.7182818284590452354</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-log2e">
   <term>
    <constant>M_LOG2E</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>log<subscript>2</subscript>(e)</literal>
     的近似值（<literal>1.4426950408889634074</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-log10e">
   <term>
    <constant>M_LOG10E</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>log<subscript>10</subscript>(e)</literal>
     的近似值（<literal>0.43429448190325182765</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-ln2">
   <term>
    <constant>M_LN2</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>ln(2)</literal> 的近似值（<literal>0.69314718055994530942</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-ln10">
   <term>
    <constant>M_LN10</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>ln(10)</literal> 的近似值（<literal>2.30258509299404568402</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-pi-2">
   <term>
    <constant>M_PI_2</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>π/2</literal> 的近似值（<literal>1.57079632679489661923</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-pi-4">
   <term>
    <constant>M_PI_4</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>π/4</literal> 的近似值（<literal>0.78539816339744830962</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-1-pi">
   <term>
    <constant>M_1_PI</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>1/π</literal> 的近似值（<literal>0.31830988618379067154</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-2-pi">
   <term>
    <constant>M_2_PI</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>2/π</literal> 的近似值（<literal>0.63661977236758134308</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-sqrtpi">
   <term>
    <constant>M_SQRTPI</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>sqrt(π)</literal> 的近似值（<literal>1.77245385090551602729</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-2-sqrtpi">
   <term>
    <constant>M_2_SQRTPI</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>2/sqrt(π)</literal> 的近似值（<literal>1.12837916709551257390</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-sqrt2">
   <term>
    <constant>M_SQRT2</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>sqrt(2)</literal> 的近似值（<literal>1.41421356237309504880</literal>).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-sqrt3">
   <term>
    <constant>M_SQRT3</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>sqrt(3)</literal> 的近似值（<literal>1.73205080756887729352</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-sqrt1-2">
   <term>
    <constant>M_SQRT1_2</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>1/sqrt(2)</literal> 的近似值（<literal>0.70710678118654752440</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-lnpi">
   <term>
    <constant>M_LNPI</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     <literal>ln(π)</literal> 的近似值（<literal>1.14472988584940017414</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.m-euler">
   <term>
    <constant>M_EULER</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     欧拉常数 γ 的近似值（<literal>0.57721566490153286061</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>IEEE 754 浮点数常量</title>
  <varlistentry xml:id="constant.nan">
   <term>
    <constant>NAN</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     不是数字
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.inf">
   <term>
    <constant>INF</constant>
    (<type>float</type>)
   </term>
   <listitem>
    <simpara>
     无穷
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>舍入常量</title>
  <note>
   <simpara>
    自 PHP 8.4.0 起，建议改用 RoundingMode 枚举。
   </simpara>
  </note>
  <varlistentry xml:id="constant.php-round-half-up">
   <term>
    <constant>PHP_ROUND_HALF_UP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     四舍五入（当值为 .5 时，向远离 0 的方向舍入。如 -2.5 舍入为 -3，2.5 舍入为 3）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-round-half-down">
   <term>
    <constant>PHP_ROUND_HALF_DOWN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     四舍五入（当值为 .5 时，向朝向 0 的方向舍入。如 -2.5 舍入为 -2，2.5 舍入为 2）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-round-half-even">
   <term>
    <constant>PHP_ROUND_HALF_EVEN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     银行家舍入（四舍六入五取偶法）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-round-half-odd">
   <term>
    <constant>PHP_ROUND_HALF_ODD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     四舍六入五取奇法（跟四舍六入五取偶法相对。但是中文并没有相关示例）
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>
</appendix>
<!-- 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
-->