cvs: phpdoc /ja/functions fdf.xml math.xml

hirokawa Wed Jan 2 08:43:09 2002 EDT Modified files: /phpdoc/ja/functions fdf.xml math.xml Log: translation updated.

Index: phpdoc/ja/functions/fdf.xml diff -u phpdoc/ja/functions/fdf.xml:1.12 phpdoc/ja/functions/fdf.xml:1.13 --- phpdoc/ja/functions/fdf.xml:1.12 Mon Dec 24 10:01:25 2001 +++ phpdoc/ja/functions/fdf.xml Wed Jan 2 08:43:09 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <reference id="ref.fdf"> <title>Forms Data Format 関数</title> <titleabbrev>FDF</titleabbrev> @@ -20,7 +20,7 @@ fdftk-dir/include および fdftk-dir/lib にある必要があります。 FdfTk の配布ファイルを単に解凍しただけだとしたら、このように はなりません。 - </simpara> + </simpara> </note> <simpara> FDFの基本的な考えは、HTMLフォームに似ています。基本的な違いは、投 @@ -289,8 +289,8 @@ </funcsynopsis> <para> <function>fdf_set_value</function> 関数は、フィールドの値を設定し - ます。最後のパラメータは、フィールドの値をPDFの名前に変換する - (<parameter>isName</parameter> = 1)か、PDF文字列に設定する + ます。最後のパラメータは、フィールドの値をPDF Nameに変換する + (<parameter>isName</parameter> = 1)か、PDF Stringに設定する (<parameter>isName</parameter> = 0)かを定義します。 </para> <para> @@ -310,7 +310,9 @@ <funcprototype> <funcdef>string <function>fdf_next_field_name</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>string + <parameter><optional>fieldname</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -320,8 +322,8 @@ フィールドの名前を返します。 </para> <para> - <function>fdf_set_field</function>, - <function>fdf_get_field</function> も参照下さい。 + <function>fdf_set_value</function>, + <function>fdf_get_value</function> も参照下さい。 </para> </refsect1> </refentry> Index: phpdoc/ja/functions/math.xml diff -u phpdoc/ja/functions/math.xml:1.23 phpdoc/ja/functions/math.xml:1.24 --- phpdoc/ja/functions/math.xml:1.23 Wed Dec 12 15:53:16 2001 +++ phpdoc/ja/functions/math.xml Wed Jan 2 08:43:09 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> - +<!-- $Revision: 1.24 $ --> <reference id="ref.math"> <title>数学関数</title> <titleabbrev>Math</titleabbrev> @@ -121,7 +121,6 @@ た定数はPHP 4のCVSコードでのみ使用可能です。 </para> </sect2> - </sect1> </partintro> @@ -164,7 +163,33 @@ 引数argのアークコサインをラジアンで返します。 </para> <para> - <function>asin</function>と<function>atan</function>も参照下さい。 + <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> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>acosh</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>arg</parameter>の逆双曲線余弦、すなわち、 + 双曲線余弦が<parameter>arg</parameter>である値を返します。 + </para> + &note.no-windows; + <para> + <function>acos</function>, <function>asin</function> + <function>atan</function>も参照下さい。 </para> </refsect1> </refentry> @@ -186,11 +211,37 @@ 引数argのアークサインをラジアンで返します。 </para> <para> - <function>acos</function>と<function>atan</function>も参照下さい。 + <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> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>asinh</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> @@ -208,7 +259,33 @@ 引数argのアークタンジェントをラジアンで返します。 </para> <para> - <function>acos</function>と<function>atan</function>も見てください。 + <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> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>atanh</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>arg</parameter>の逆双曲線正接、すなわち、 + 双曲線正接が<parameter>arg</parameter>となる値を返します。 + </para> + &note.no-windows; + <para> + <function>atan</function>, <function>asin</function>, + <function>acos</function>も参照下さい。 </para> </refsect1> </refentry> @@ -271,7 +348,9 @@ <example> <title><function>base_convert</function></title> <programlisting role="php"> -$binary = base_convert($hexadecimal, 16, 2); +<![CDATA[ +$binary = base_convert ($hexadecimal, 16, 2); +]]> </programlisting> </example> </para> @@ -354,9 +433,33 @@ </refsect1> </refentry> + <refentry id="function.cosh"> + <refnamediv> + <refname>cosh</refname> + <refpurpose>双曲線余弦</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>cosh</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> + <refname>decbin</refname> <refpurpose> 10 進数を 2進数 に変換します</refpurpose> </refnamediv> <refsect1> @@ -380,7 +483,7 @@ <refentry id="function.dechex"> <refnamediv> - <refname>DecHex</refname> + <refname>dechex</refname> <refpurpose> 10 進数を 16 進数に変換します</refpurpose> </refnamediv> <refsect1> @@ -403,7 +506,7 @@ <refentry id="function.decoct"> <refnamediv> - <refname>DecOct</refname> + <refname>decoct</refname> <refpurpose>10 進数を 8 進数に変換します。</refpurpose> </refnamediv> <refsect1> @@ -469,6 +572,28 @@ </refsect1> </refentry> + <refentry id='function.expm1'> + <refnamediv> + <refname>expm1</refname> + <refpurpose> + 値がゼロに近い時にでも精度を保つためにexp(number)-1を返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>expm1</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.floor"> <refnamediv> <refname>floor</refname> @@ -483,11 +608,20 @@ </funcprototype> </funcsynopsis> <simpara> - <parameter>value</parameter>から最も近い最小の整数の値を返します。 - <function>floor</function>の返り値は、<type>float</type>型のまま - となります。これは、<type>float</type>の範囲は<type>int</type>よ - りも広いためです。 + 必要に応じて<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> も参照下 さい。 @@ -498,26 +632,23 @@ <refentry id="function.getrandmax"> <refnamediv> <refname>getrandmax</refname> - <refpurpose>乱数の最大値を示します</refpurpose> + <refpurpose>乱数の最大値を取得する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> <funcdef>int <function>getrandmax</function></funcdef> - <paramdef>void</paramdef> + <void/> </funcprototype> </funcsynopsis> - <simpara> <function>rand</function> をコールすることにより得られる 最大の値を返します。 </simpara> <simpara> - <function>rand</function>, - <function>srand</function>, - <function>mt_rand</function>, - <function>mt_srand</function>, + <function>rand</function>, <function>srand</function>, + <function>mt_rand</function>, <function>mt_srand</function>, <function>mt_getrandmax</function> も参照下さい。 </simpara> @@ -541,13 +672,50 @@ 引数 <parameter>hex_string</parameter> により指定された 16進数に 等価な 10 進数を返します。<function>hexdec</function>は、16進数を 表す文字列を10進数に変換します。変換できる最大の数字は16進数の - 7fffffffもしくは10進数の2147483647です。 + 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> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>hypot</function></funcdef> + <paramdef>float <parameter>num1</parameter></paramdef> + <paramdef>float <parameter>num2</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> <refentry id="function.lcg-value"> <refnamediv> @@ -603,7 +771,29 @@ </funcprototype> </funcsynopsis> <para> - arg の底数 10 の対数を返します。 + <parameter>arg</parameter>の底数 10 の対数を返します。 + </para> + </refsect1> + </refentry> + + <refentry id='function.log1p'> + <refnamediv> + <refname>log1p</refname> + <refpurpose> + ゼロに近い場合の精度を維持するため、log(1 + number)を返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log1p</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> @@ -637,7 +827,7 @@ <para> 数値の 1 つ以上が倍精度実数の場合は、全ての数値が倍精度実数として 扱われ、倍精度実数で返されます。 - 数値に倍精度実数が全く無い場合、全ては整数として扱ィ?、 + 数値に倍精度実数が全く無い場合、全ては整数として処理され、 整数を返します。 </para> </refsect1> @@ -733,10 +923,8 @@ </para> </note> <simpara> - <function>mt_srand</function>, - <function>mt_getrandmax</function>, - <function>srand</function>, - <function>rand</function> , + <function>mt_srand</function>, <function>mt_getrandmax</function>, + <function>srand</function>, <function>rand</function> , <function>getrandmax</function> も参照下さい。 </simpara> </refsect1> @@ -759,17 +947,21 @@ <parameter>seed</parameter> で乱数生成器にシードを与えます。 <informalexample> <programlisting> -// マイクロ秒で表した時間によりシードを与えます。 -mt_srand((double)microtime()*1000000); +<![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>mt_rand</function>, <function>mt_getrandmax</function>, + <function>srand</function>, <function>rand</function> , <function>getrandmax</function> も参照下さい。 </simpara> </refsect1> @@ -793,10 +985,8 @@ ます。 </simpara> <simpara> - <function>mt_rand</function>, - <function>mt_srand</function>, - <function>rand</function>, - <function>srand</function>, + <function>mt_rand</function>, <function>mt_srand</function>, + <function>rand</function>, <function>srand</function>, <function>getrandmax</function> も参照下さい。 </simpara> </refsect1> @@ -866,7 +1056,8 @@ 文字として使用します。これは、次のように行います。 </para> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $nombre = 1234.56; @@ -884,7 +1075,8 @@ $english_format_number = number_format($number, 2, '.', ''); // 1234.56 -?&gt; +?> +]]> </programlisting> </example> </para> @@ -925,7 +1117,7 @@ <refentry id="function.pi"> <refnamediv> <refname>pi</refname> - <refpurpose>円周率の値を得ます</refpurpose> + <refpurpose>円周率の値を得る</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -941,10 +1133,10 @@ <para> <informalexample> <programlisting> - +<![CDATA[ echo pi(); // 3.1415926535898 を出力します。 - +]]> </programlisting> </informalexample> </para> @@ -960,9 +1152,9 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>float <function>pow</function></funcdef> - <paramdef>float <parameter>base</parameter></paramdef> - <paramdef>float <parameter>exp</parameter></paramdef> + <funcdef>number <function>pow</function></funcdef> + <paramdef>number <parameter>base</parameter></paramdef> + <paramdef>number <parameter>exp</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1100,14 +1292,32 @@ <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"> -$foo = round( 3.4 ); // $foo == 3.0 -$foo = round( 3.5 ); // $foo == 4.0 -$foo = round( 3.6 ); // $foo == 4.0 +<![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( 1.95583 , 2 ); // $foo == 1.96 +$foo = round(1241757, -3); // $foo == 1242000 +]]> </programlisting> </informalexample> </para> @@ -1143,8 +1353,31 @@ サインをラジアンで返します。 </para> <para> - <function>cos</function> と - <function>tan</function> も参照下さい。 + <function>cos</function>と<function>tan</function> も参照下さい。 + </para> + </refsect1> + </refentry> + + <refentry id="function.sinh"> + <refnamediv> + <refname>sinh</refname> + <refpurpose>双曲線正弦</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>sinh</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> @@ -1168,6 +1401,8 @@ </refsect1> </refentry> + + <refentry id="function.srand"> <refnamediv> <refname>srand</refname> @@ -1186,9 +1421,15 @@ 初期化します。 <informalexample> <programlisting role="php"> +<![CDATA[ // マイクロでシードを設定する -srand((double)microtime()*1000000); +function make_seed() { + list($usec, $sec) = explode(' ', microtime()); + return (float) $sec + ((float) $usec * 100000); +} +srand(make_seed()); $randval = rand(); +]]> </programlisting> </informalexample> </para> @@ -1218,6 +1459,30 @@ </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> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>tanh</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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>