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>
+ ¬e.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>
+ ¬e.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>
+ ¬e.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">
-<?php
+<![CDATA[
+<?php
$nombre = 1234.56;
@@ -884,7 +1075,8 @@
$english_format_number = number_format($number, 2, '.', '');
// 1234.56
-?>
+?>
+]]>
</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>
