<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.25 $ -->
 <reference id="ref.math">
  <title>数学関数</title>
  <titleabbrev>Math</titleabbrev>

  <partintro>
   <sect1 id="math.intro">
    <title>導入</title>
    <para>
     これらの数学関数は、実行するコンピューターの倍精度整数(long)およ
     び倍精度実数(double)の範囲でのみ値を処理します。より大きな数を処
     理する必要がある場合には、<link linkend="ref.bc">任意精度数学関数
     </link>の使用をお勧めします。
    </para>
    <sect2 id="math.constants">
     <title>数学定数</title>
     <para>
      以下の値は PHP の数学拡張機能により定数として定義されています。
      <table>
       <title>数学定数</title>
       <tgroup cols="3">
 	<thead>
 	 <row>
 	  <entry>定数</entry>
 	  <entry>値</entry>
 	  <entry>説明</entry>
 	 </row>
 	</thead>
 	<tbody>
 	 <row>
 	  <entry>M_PI</entry>
 	  <entry>3.14159265358979323846</entry>
 	  <entry>円周率 (pi)</entry>
 	 </row>
	 <row>
	  <entry>M_E</entry>
	  <entry>2.7182818284590452354</entry>
	  <entry>e</entry>
	 </row>
	 <row>
	  <entry>M_LOG2E</entry>	
	  <entry>1.4426950408889634074</entry>	
	  <entry>log_2 e</entry>
	 </row>
	 <row>
	  <entry>M_LOG10E</entry>
	  <entry>0.43429448190325182765</entry>	
	  <entry>log_10 e</entry>
	 </row>
	 <row>
	  <entry>M_LN2</entry>	
	  <entry>0.69314718055994530942</entry>		
	  <entry>log_e 2</entry>
	 </row>
	 <row>
	  <entry>M_LN10</entry>	
	  <entry>2.30258509299404568402</entry>	
	  <entry>log_e 10</entry>
	 </row>
	 <row>
	  <entry>M_PI_2</entry>
	  <entry>1.57079632679489661923</entry>	
	  <entry>pi/2</entry>
	 </row>
	 <row>
	  <entry>M_PI_4</entry>
	  <entry>0.78539816339744830962</entry>	
	  <entry>pi/4</entry>
	 </row>
	 <row>
	  <entry>M_1_PI</entry>
	  <entry>0.31830988618379067154</entry>	
	  <entry>1/pi</entry>
	 </row>
	 <row>
	  <entry>M_2_PI</entry>
	  <entry>0.63661977236758134308</entry>	
	  <entry>2/pi</entry>
	 </row>
	 <row>
	  <entry>M_SQRTPI</entry>	
	  <entry>1.77245385090551602729</entry>	
	  <entry>sqrt(pi) [4.0.2]</entry>
	 </row>
	 <row>
	  <entry>M_2_SQRTPI</entry>	
	  <entry>1.12837916709551257390</entry>	
	  <entry>2/sqrt(pi)</entry>
	 </row>
	 <row>
	  <entry>M_SQRT2</entry>	
	  <entry>1.41421356237309504880</entry>	
	  <entry>sqrt(2)</entry>
	 </row>
	 <row>
	  <entry>M_SQRT3</entry>	
	  <entry>1.73205080756887729352</entry>	
	  <entry>sqrt(3) [4.0.2]</entry>
	 </row>
	 <row>
	  <entry>M_SQRT1_2</entry>	
	  <entry>0.70710678118654752440</entry>	
	  <entry>1/sqrt(2)</entry>
	 </row>
	 <row>
	  <entry>M_LNPI</entry>	
	  <entry>1.14472988584940017414</entry>	
	  <entry>log_e(pi) [4.0.2]</entry>
	 </row>
	 <row>
	  <entry>M_EULER</entry>	
	 <entry>0.57721566490153286061</entry>	
	  <entry>オイラー定数 [4.0.2]</entry>
	 </row>
 	</tbody>
       </tgroup>
      </table>
      PHP 4RC1までのバージョンのPHPでは、M_PIのみが使用可能です。他の全
      ての定数は、PHP 4.0 で使用可能となりました。[4.0.2] とラベルのつい
      た定数はPHP 4のCVSコードでのみ使用可能です。
     </para>
    </sect2>
   </sect1>
  </partintro>
 
  <refentry id="function.abs">
   <refnamediv>
    <refname>abs</refname>
    <refpurpose>絶対値</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>mixed</type><methodname>abs</methodname>
      <methodparam><type>mixed</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     numberの絶対値を返します。引数numberが<type>float</type>の場合は
     帰り値も<type>float</type>となり、その他の場合は、
     <type>int</type>を返します。(これは、<type>float</type>の範囲は、
     <type>int</type>よりも広いためです。)
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.acos">
   <refnamediv>
    <refname>acos</refname>
    <refpurpose>アークコサイン</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>acos</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数argのアークコサインをラジアンで返します。
    </para>
    <para>
     <function>acosh</function>, <function>asin</function>,
     <function>atan</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.acosh">
   <refnamediv>
    <refname>acosh</refname>
    <refpurpose>逆双曲線余弦</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>acosh</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>arg</parameter>の逆双曲線余弦、すなわち、
     双曲線余弦が<parameter>arg</parameter>である値を返します。
    </para>
    &note.no-windows;
    <para>
     <function>acos</function>, <function>asin</function>
     <function>atan</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.asin">
   <refnamediv>
    <refname>asin</refname>
    <refpurpose>アークサイン</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>asin</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数argのアークサインをラジアンで返します。
    </para>
    <para>
     <function>asinh</function>, <function>acos</function>,
     <function>atan</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.asinh">
   <refnamediv>
    <refname>asinh</refname>
    <refpurpose>逆双曲線正弦</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>asinh</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>arg</parameter>の逆双曲線正弦、すなわち、双曲線正弦が
     <parameter>arg</parameter>であるような値を返します。
    </para>
    &note.no-windows;
    <para>
     <function>asin</function>, <function>acos</function>,
     <function>atan</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.atan">
   <refnamediv>
    <refname>atan</refname>
    <refpurpose>アークタンジェント</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>atan</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数argのアークタンジェントをラジアンで返します。
    </para>
    <para>
     <function>atanh</function>, <function>acos</function>,
     <function>atan</function>も見てください。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.atanh">
   <refnamediv>
    <refname>atanh</refname>
    <refpurpose>逆双曲線正接</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>atanh</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>arg</parameter>の逆双曲線正接、すなわち、
     双曲線正接が<parameter>arg</parameter>となる値を返します。
    </para>
    &note.no-windows;
    <para>
     <function>atan</function>, <function>asin</function>,
     <function>acos</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.atan2">
   <refnamediv>
    <refname>atan2</refname>
    <refpurpose>2変数のアークタンジェント</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>atan2</methodname>
      <methodparam><type>float</type><parameter>y</parameter></methodparam>
      <methodparam><type>float</type><parameter>x</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     この関数は、変数 x,y のアークタンジェントを計算します。
     y / x のアークタンジェントを計算するのに似ていますが、
     2つの引数の符号を用いて結果の4象元位置を定義する
     ことが異なっています。
    </simpara>
    <simpara>
     この関数は、結果を -PI から PI の間(両端を含む)のラジアンで返しま
     す。
    </simpara>
    <para>
     <function>acos</function> および <function>atan</function>
     も参照下さい。
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.base-convert">
   <refnamediv>
    <refname>base_convert</refname>
    <refpurpose>任意の基底に変換する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>strin</type><methodname>base_convert</methodname>
      <methodparam><type>string</type><parameter>number</parameter></methodparam>
      <methodparam><type>int</type><parameter>frombase</parameter></methodparam>
      <methodparam><type>int</type><parameter>tobase</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>number</parameter> を基底 <parameter>tobase</parameter> 
     で表した文字列を返します。
     <parameter>number</parameter> の基底は、
     <parameter>frombase</parameter> で指定します。
     <parameter>frombase</parameter> および <parameter>tobase</parameter>
     は共に2から36までである必要があります。
     10 より大きな基底を有する数の各桁は、文字 a-z で表されます。
     この場合、a は 10、b は 11、z は 36 を意味します。
     <example>
      <title><function>base_convert</function></title>
      <programlisting role="php">
<![CDATA[
$binary = base_convert ($hexadecimal, 16, 2);
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.bindec">
   <refnamediv>
    <refname>BinDec</refname>
    <refpurpose> 2進数 を 10 進数に変換します</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>bindec</methodname>
      <methodparam><type>string</type><parameter>binary_string</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数 binary_string により指定された 2進数 と等価な 10 進数を返し
     ます。
    </para>
    <para>
     <function>bindec</function>は、2進数を<type>integer</type>に変換
     します。変換可能な最も大きな数字は 1 が 31 ビット並んだ 2進数で
     あり、10進数の2147483647です。
    </para>
    <para>
     <function>decbin</function> 関数も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ceil">
   <refnamediv>
    <refname>ceil</refname>
    <refpurpose>切り上げ</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>ceil</methodname>
      <methodparam><type>float</type><parameter>value</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <parameter>value</parameter>の次に大きい整数値を返します。
     <function>ceil</function>の返り値は、<type>float</type>型となりま
     す。これは、<type>float</type>値の範囲は通常<type>int</type>より
     も広いためです。
    </simpara>
    <simpara>
     <function>floor</function> と <function>round</function> も参照
     下さい。
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.cos">
   <refnamediv>
    <refname>cos</refname>
    <refpurpose>コサイン</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>cos</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     argのコサインをラジアンで返します。
    </para>
    <para>
     <function>sin</function> と <function>tan</function> も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.cosh">
   <refnamediv>
    <refname>cosh</refname>
    <refpurpose>双曲線余弦</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>cosh</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <literal>(exp(arg) + exp(-arg))/2</literal>で定義される
     <parameter>arg</parameter>の双曲線余弦を返します。
    </para>
    <para>
     <function>cos</function>, <function>acosh</function>,
     <function>sin</function>, <function>tan</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.decbin">
   <refnamediv>
    <refname>decbin</refname>
    <refpurpose> 10 進数を 2進数 に変換します</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>decbin</methodname>
      <methodparam><type>int</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数numberを2進数表現した文字列を返します。変換することが出来る最
     大の数は 10 進数の 2147483647 であり、31 ビット 1 が並んだ 2進数
     となります。
    </para>
    <para>
     <function>bindec</function> も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dechex">
   <refnamediv>
    <refname>dechex</refname>
    <refpurpose> 10 進数を 16 進数に変換します</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>dechex</methodname>
      <methodparam><type>int</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数numberを 16 進数表現した文字列を返します。変換できる最大の数
     字は 2147483647 であり、"7ffffffff"を返します。
    </para>
    <para>
     <function>hexdec</function> も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.decoct">
   <refnamediv>
    <refname>decoct</refname>
    <refpurpose>10 進数を 8 進数に変換します。</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>decoct</methodname>
      <methodparam><type>int</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数numberを 8 進数表現した文字列を返します。変換出来る最大の数字
     は 10 進数の 2147483647 であり、"17777777777" を返します。
     <function>octdec</function> も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.deg2rad">
   <refnamediv>
    <refname>deg2rad</refname>
    <refpurpose>
     度単位の数値をラジアン単位に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>double</type><methodname>deg2rad</methodname>
      <methodparam><type>double</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     この関数は、<parameter>number</parameter>を度単位からラジアンに変
     換します。
    </para>
    <para>
     <function>rad2deg</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.exp">
   <refnamediv>
    <refname>exp</refname>
    <refpurpose>自然対数 e の累乗を計算します</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>exp</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     e を <parameter>arg</parameter> 乗した値を返します。
    </para>
    <para>
     <function>pow</function> も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.expm1'>
   <refnamediv>
    <refname>expm1</refname>
    <refpurpose>
     値がゼロに近い時にでも精度を保つためにexp(number)-1を返す
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>expm1</methodname>
      <methodparam><type>float</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
     &warn.experimental.func;
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.floor">
   <refnamediv>
    <refname>floor</refname>
    <refpurpose>切捨て</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>floor</methodname>
      <methodparam><type>float</type><parameter>value</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     必要に応じて<parameter>value</parameter>を丸めることにより、最も
     近い最小の整数の値を返します。<function>floor</function>の返り値
     は、<type>float</type>型のままとなります。これは、
     <type>float</type>の範囲は<type>int</type>よりも広いためです。
    </simpara>
    <example>
     <title><function>floor</function>の例</title>
     <programlisting role="php">
<![CDATA[
$four = floor(4.3);   // $four = 4.0;
$nine = floor(9.999); // $nine = 9.0;
]]>
     </programlisting>
    </example>
    <simpara>
     <function>ceil</function> と <function>round</function> も参照下
     さい。
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.getrandmax">
   <refnamediv>
    <refname>getrandmax</refname>
    <refpurpose>乱数の最大値を取得する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>getrandmax</methodname>
      <void/>
     </methodsynopsis>
    <simpara>
     <function>rand</function> をコールすることにより得られる
     最大の値を返します。
    </simpara>
    <simpara>
     <function>rand</function>, <function>srand</function>, 
     <function>mt_rand</function>, <function>mt_srand</function>,
     <function>mt_getrandmax</function>
     も参照下さい。
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.hexdec">
   <refnamediv>
    <refname>HexDec</refname>
    <refpurpose>16 進数を 10 進数に変換します。</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>hexdec</methodname>
      <methodparam><type>string</type><parameter>hex_string</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数 <parameter>hex_string</parameter> により指定された 16進数に
     等価な 10 進数を返します。<function>hexdec</function>は、16進数を
     表す文字列を10進数に変換します。変換できる最大の数字は16進数の
     7fffffffもしくは10進数の2147483647です。
     <example>
      <title><function>hexdec</function>の例</title>
      <programlisting role="php">
<![CDATA[
var_dump(hexdec("See"));
var_dump(hexdec("ee"));
// 共に"int(238)"を出力

var_dump(hexdec("that"));
var_dump(hexdec("a0"));
// 共にint(160)を出力
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <function>dechex</function> 関数も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.hypot'>
   <refnamediv>
    <refname>hypot</refname>
    <refpurpose>
     sqrt( num1*num1 + num2*num2)を返す
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>hypot</methodname>
      <methodparam><type>float</type><parameter>num1</parameter></methodparam>
      <methodparam><type>float</type><parameter>num2</parameter></methodparam>
     </methodsynopsis>
    &warn.experimental.func;
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.lcg-value">
   <refnamediv>
    <refname>lcg_value</refname>
    <refpurpose>複合型の線形合同発生器(LCG)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>double</type><methodname>lcg_value</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>lcg_value</function> は、(0, 1)の範囲の疑似乱数を返しま
     す。この関数は、周期が2^31 - 85および2^31 - 249の2つの CG を組み
     合わせます。この関数の周期はこれら2つの素数の積と等価です。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.log">
   <refnamediv>
    <refname>log</refname>
    <refpurpose>自然対数</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>log</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     arg の自然対数を返します。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.log10">
   <refnamediv>
    <refname>log10</refname>
    <refpurpose>底数 10 の対数</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>log10</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>arg</parameter>の底数 10 の対数を返します。
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.log1p'>
   <refnamediv>
    <refname>log1p</refname>
    <refpurpose>
     ゼロに近い場合の精度を維持するため、log(1 + number)を返す
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>log1p</methodname>
      <methodparam><type>float</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    &warn.experimental.func;
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.max">
   <refnamediv>
    <refname>max</refname>
    <refpurpose>最も大きい数値を返す</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>mixed</type><methodname>max</methodname>
      <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>argn</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>max</function>は変数値の最も大きい数値を返します。
    </para>
    <para>
     最初の変数が配列の場合は、 <function>max</function> は
     配列の中で最も大きい数値を返します。
     始めの変数が整数、文字列、倍精度実数の場合、少なくとも
     2 つの変数が必要であり、 <function>max</function>
     はそれらの数値の最も大きいものを返します。
     比較する数値の数に制限はありません。
    </para>
    <para>
     数値の 1 つ以上が倍精度実数の場合は、全ての数値が倍精度実数として
     扱われ、倍精度実数で返されます。
     数値に倍精度実数が全く無い場合、全ては整数として処理され、
     整数を返します。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.min">
   <refnamediv>
    <refname>min</refname>
    <refpurpose>最も小さい値を返す</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>mixed</type><methodname>min</methodname>
      <methodparam><type>mixed</type><parameter>arg1</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>arg2</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>argn</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>min</function> は変数の中で最も小さい数字を
     返します。
    </para>
    <para>
     最初の変数が配列の場合、 <function>min</function>配列の中の最も小
     さい数値を返します。最初の変数が整数、文字列、倍精度実数の場合、
     少なくとも2つの変数が必要であり、 <function>min</function> はそれ
     らの数値の最も小さい値を返します。
    </para>
    <para>
     1つ以上の値が倍精度実数の場合、全ての値は倍精度実数で扱われ、倍精
     度実数で返されます。倍精度実数の値が全く無い場合、全て整数として
     扱われ、整数を返します。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mt-rand">
   <refnamediv>
    <refname>mt_rand</refname>
    <refpurpose>改良型乱数値を生成する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>mt_rand</methodname>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>min</optional></replaceable>
       </parameter></methodparam>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>max</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     古いlibcの多くの乱数発生器は、怪しげであるか特性が不明であったり
     し、また低速でした。デフォルトでは、PHP は
     <function>rand</function> においてlibcの乱数発生器を使用します。
     <function>mt_rand</function> 関数は、その代替品となるものです。
     この関数は、既知の特性を有する乱数生成器である Mersenne Twister 
     を使用し、暗号用途に適した乱数を生成します。
     この関数は、平均的な libc の相当品よりも 4 倍高速です。
     Mersenne Twister のホームページは、<ulink
     url="&url.mersenne;">&url.mersenne;</ulink> にあります。
     MT ソースの最適化された版は、<ulink 
     url="&url.mersenne.twister;">&url.mersenne.twister;</ulink> 
     にて入手可能です。
    </simpara>
    <simpara>
     オプションの引数
     <parameter>min</parameter>,<parameter>max</parameter>を付けずにコー
     ルした場合、<function>mt_rand</function> は 0 から
     <constant>RAND_MAX</constant>の間の擬似乱数値を返します。
     例えば、5から15まで(端点を含む)の間の乱数値を得たい場合には、
     <literal>mt_rand(5,15)</literal> として下さい。
    </simpara>
    <simpara>
     使用する前に<function>mt_srand</function> により乱数生成器にシー
     ドを与えることを忘れないようにして下さい。
    </simpara>
    <note>
     <para>
      3.0.7より前のバージョンでは、<parameter>max</parameter>の意味は
      <parameter>range</parameter>でした。これらのバージョンにおいて
      同じ結果を得るために簡単な例を示すと、5から15までの乱数を得たい
      場合には <literal>mt_rand (5, 11)</literal>とする必要があります。
     </para>
    </note>
    <simpara>
     <function>mt_srand</function>, <function>mt_getrandmax</function>,
     <function>srand</function>, <function>rand</function> ,
     <function>getrandmax</function> も参照下さい。
    </simpara>
   </refsect1>
  </refentry>
 
  <refentry id="function.mt-srand">
   <refnamediv>
    <refname>mt_srand</refname>
    <refpurpose>改良型乱数生成器にシードを与える</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>void</type><methodname>mt_srand</methodname>
      <methodparam><type>int</type><parameter>seed</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>seed</parameter> で乱数生成器にシードを与えます。
     <informalexample>
      <programlisting>
<![CDATA[
// マイクロ秒で表した時間によりシード
function make_seed() {
    list($usec, $sec) = explode(' ', microtime());
    return (float) $sec + ((float) $usec * 100000);
}
mt_srand(make_seed());
$randval = mt_rand();
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     <function>mt_rand</function>, <function>mt_getrandmax</function>,
     <function>srand</function>, <function>rand</function> ,
     <function>getrandmax</function> も参照下さい。
    </simpara>
   </refsect1>
  </refentry>
 
  <refentry id="function.mt-getrandmax">
   <refnamediv>
    <refname>mt_getrandmax</refname>
    <refpurpose>乱数値の最大値を表示する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>mt_getrandmax</methodname>
      <void/>
     </methodsynopsis>
    <simpara>
     <function>mt_rand</function> のコールにより返される最大の値を返し
     ます。
    </simpara>
    <simpara>
     <function>mt_rand</function>, <function>mt_srand</function>,
     <function>rand</function>, <function>srand</function>,
     <function>getrandmax</function> も参照下さい。
    </simpara>
   </refsect1>
  </refentry>
 
  <refentry id="function.number-format">
   <refnamediv>
    <refname>number_format</refname>
    <refpurpose>1,000 単位で数字をフォーマットする</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>number_format</methodname>
      <methodparam><type>float</type><parameter>number</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>decimals</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>dec_point</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>thousands_sep</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>number_format</function>は<parameter>number</parameter>
     をフォーマットしたものを返します。この関数は、以下に示すような
     1個,2個または 4個の引数を取ります(3個というのはありません):
     </para>
     <para>
     引数が1つだけ与えられた場合は、<parameter>number</parameter>が
     各々1000の位ごとにカンマ(",")区切りでフォーマットされますが、
     小数部は出力されません。
    </para>
    <para>
     引数が2つ与えられた場合は、<parameter>number</parameter>が各々
     1000の位ごとにカンマ(",")区切りででフォーマットされ、さらにドッ
     ト(".")1つを置いて、その後に小数部が<parameter>decimals
     </parameter>桁数分出力されます。
    </para>
    <para>
     4つの引数すべてが与えられた場合は、<parameter>number</parameter>
     が<parameter>decimals</parameter>桁数分の小数部を含んだ形でフォ
     ーマットされます。その際、各々1000の位ごとの区切り文字として、
     カンマ(",")の代わりに<parameter>thousands_sep</parameter>で与
     えられた文字列を使い、小数部の前のドット(".")の代わりに
     <parameter>dec_point</parameter>で与えられた文字列を使います。
    </para>
    <note>
     <para>
      <parameter>thousands_sep</parameter>の最初の文字のみが使用され
      ます。例えば、数値<literal>1000</literal>について
      <literal>foo</literal> を<parameter>thousands_sep</parameter>
      に使用した場合、<function>number_format</function> は、
      <literal>1f000</literal>を返します。
     </para>
    </note>
    <para>
    <example>
     <title><function>number_format</function> の例</title>
      <para>
       例えば、フランス語表記では通常小数点以下は2桁とし、カンマ
       (',')を小数部の区切り文字、スペース(' ')を1000の位毎の区切り
       文字として使用します。これは、次のように行います。
      </para>
      <programlisting role="php">
<![CDATA[
<?php

    $nombre = 1234.56;

    // 英語表記 (デフォルト)
    $english_format_number = number_format($nombre);
    // 1,234.56

    // フランス語表記
    $nombre_format_francais = number_format($nombre, 2, ',', ' ');
    // 1 234,56

    $number = 1234.5678;

    // 千単位の区切りがない英語表記
    $english_format_number = number_format($number, 2, '.', '');
    // 1234.56

?>
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      <function>sprintf</function>,
      <function>printf</function> , <function>sscanf</function>も
      参照下さい。
     </para>
    </note>
   </refsect1>
  </refentry>
 
  <refentry id="function.octdec">
   <refnamediv>
    <refname>OctDec</refname>
    <refpurpose>8進数を10進数に変換する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>octdec</methodname>
      <methodparam><type>string</type><parameter>octal_string</parameter></methodparam>
     </methodsynopsis>
    <para>
     octal_string により指定された8進数を10進数表現した数値を返します。
     OctDec は 8 進数を 10 進数に変換します。変換可能な最も大きな数値
     は 8進数の 17777777777 もしくは 10進数の 2147483647 です。
    </para>
    <para>
     <function>decoct</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pi">
   <refnamediv>
    <refname>pi</refname>
    <refpurpose>円周率の値を得る</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>double</type><methodname>pi</methodname>
      <void/>
     </methodsynopsis>
    <simpara>
     円周率の近似値を返します。
    </simpara>
    <para>
     <informalexample>
      <programlisting>
<![CDATA[       
echo pi();
// 3.1415926535898 を出力します。
]]>
      </programlisting>
     </informalexample>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pow">
   <refnamediv>
    <refname>pow</refname>
    <refpurpose>指数関数値</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>number</type><methodname>pow</methodname>
      <methodparam><type>number</type><parameter>base</parameter></methodparam>
      <methodparam><type>number</type><parameter>exp</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>base</parameter> の <parameter>exp</parameter> 乗を返
     します。可能な場合、この関数は、<type>integer</type>型の値を
     返します。
    </para>
    <para>
     累乗が計算できない場合、警告が発生し、
     <function>pow</function> は &false;を返します。
    </para>
    <example>
     <title><function>pow</function>の例</title>
     <programlisting role="php">
<![CDATA[
<?php

var_dump( pow(2,8) ); // int(256)
echo pow(-1,20); // 1
echo pow(0, 0); // 1

echo pow(-1, 5.5); // エラー

?>
]]>
     </programlisting>
    </example>
    <warning>
     <para>
      PHP 4.0.6 より前のバージョンでは、<function>pow</function>は
      常に<type>float</type>を返します。この場合、警告の問題は
      ありません。
     </para>
    </warning>
    <para> 
     <function>exp</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rad2deg">
   <refnamediv>
    <refname>rad2deg</refname>
    <refpurpose>
     ラジアン単位の数を等価な度単位の数に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>double</type><methodname>rad2deg</methodname>
      <methodparam><type>double</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     この関数は、ラジアン単位から度単位に<parameter>number</parameter>
     に変換します。
    </para>
    <para>
     <function>deg2rad</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rand">
   <refnamediv>
    <refname>rand</refname>
    <refpurpose>乱数を生成します</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>rand</methodname>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>min</optional></replaceable>
       </parameter></methodparam>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>max</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     オプションの引数
     <parameter>min</parameter>,<parameter>max</parameter>
     を省略してコールした場合、<function>rand</function>は0と
     <constant>RAND_MAX</constant>の間の擬似乱数を返します。 
     例えば、5から15までの乱数を得たい場合、
     <literal>rand(5,15)</literal>とします。
    </simpara>
    <simpara>
     使用する前に <function>srand</function> により乱数生成器を
     初期化することを忘れないようにして下さい。
    </simpara>
    <note>
     <para>
      3.0.7より前のバージョンでは、<parameter>max</parameter>の意味は
      <parameter>range</parameter>でした。これらのバージョンにおいて
      同じ結果を得るために簡単な例を示すと、
      5から15までの乱数を得たい場合には <literal>mt_rand (5, 11)</literal> 
      とする必要があります。
     </para>
    </note>
    <simpara>
     <function>srand</function>,<function>getrandmax</function>,
     <function>mt_rand</function>,<function>mt_srand</function>,
     <function>mt_getrandmax</function> も参照下さい。
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.round">
   <refnamediv>
    <refname>round</refname>
    <refpurpose>浮動点整数を整数値に丸める</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>double</type><methodname>round</methodname>
      <methodparam><type>double</type><parameter>val</parameter></methodparam>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>precision</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>val</parameter>を指定した
     <parameter>precision</parameter>(小数点以下の桁数)に丸めた値を返
     します。<parameter>precision</parameter>を負またはゼロ(デフォルト)
     とすることも可能です。
    </para>
    <para>
     <caution>
      <simpara>
       PHPは、デフォルトでは<literal>"12,300.2"</literal>のような文字
       列を正しく処理しません。<link
       linkend="language.types.string.conversion">文字列からの変換
       </link>を参照下さい。
      </simpara>
     </caution>
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
$foo = round(3.4);  // $foo == 3.0
$foo = round(3.5);  // $foo == 4.0
$foo = round(3.6);  // $foo == 4.0
$foo = round(3.6, 0);  // equivalent with above

$foo = round(1.95583, 2);  // $foo == 1.96

$foo = round(1241757, -3);  // $foo == 1242000
]]>
      </programlisting>
     </informalexample>
    </para>
    <note>
     <simpara>
      パラメータ <parameter>precision</parameter> は、PHP 4でのみ利用
      可能です。
      (訳注：内部的な2進数表現と10進数表現の差により生じる丸め誤差の影響により
      必ずしも小数点以下を四捨五入した結果を返さないことに注意して下さい。)
     </simpara>
    </note>
    <simpara>
     <function>ceil</function> と
     <function>floor</function> も参照下さい。
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.sin">
   <refnamediv>
    <refname>sin</refname>
    <refpurpose>サイン</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>sin</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     サインをラジアンで返します。
    </para>
    <para>
     <function>cos</function>と<function>tan</function> も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sinh">
   <refnamediv>
    <refname>sinh</refname>
    <refpurpose>双曲線正弦</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>sinh</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <literal>(exp(arg) - exp(-arg))/2</literal>で定義される
     <parameter>arg</parameter>の双曲線正弦を返します。
    </para>
    <para>
     <function>sin</function>, <function>asinh</function>,
     <function>cos</function>, <function>tan</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sqrt">
   <refnamediv>
    <refname>sqrt</refname>
    <refpurpose>平方根</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>sqrt</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     引数 arg の平方根を返します。
    </para>
   </refsect1>
  </refentry>



  <refentry id="function.srand">
   <refnamediv>
    <refname>srand</refname>
    <refpurpose>乱数ジェネレータを初期化する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>void</type><methodname>srand</methodname>
      <methodparam><type>int</type><parameter>seed</parameter></methodparam>
     </methodsynopsis>
    <para>
     シード <parameter>seed</parameter> で乱数ジェネレータを
     初期化します。
     <informalexample>
      <programlisting role="php">
<![CDATA[
// マイクロでシードを設定する
function make_seed() {
    list($usec, $sec) = explode(' ', microtime());
    return (float) $sec + ((float) $usec * 100000);
}
srand(make_seed());
$randval = rand();
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     <function>rand</function>,<function>getrandmax</function>,
     <function>mt_rand</function>,<function>mt_srand</function>,
     <function>mt_getrandmax</function> も参照下さい。
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.tan">
   <refnamediv>
    <refname>tan</refname>
    <refpurpose>タンジェント</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>tan</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     argのタンジェントをラジアンで返します。
    </para>
    <para>
     <function>sin</function>と<function>cos</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.tanh">
   <refnamediv>
    <refname>tanh</refname>
    <refpurpose>双曲線正接</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>float</type><methodname>tanh</methodname>
      <methodparam><type>float</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <literal>sinh(arg)/cosh(arg)</literal>で定義される
     <parameter>arg</parameter>の双曲線正接を返します。
    </para>
    <para>
     <function>tan</function>, <function>atanh</function>,
     <function>sin</function>, <function>cos</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>
  
 </reference>

<!-- 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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->