cvs: phpdoc /ja/functions funchand.xml gettext.xml ibase.xml image.xml math.xml network.xml outcontrol.xml /ja/language references.xml

From: Date: Mon, 11 Dec 2000 21:42:14 +0000
Subject: cvs: phpdoc /ja/functions funchand.xml gettext.xml ibase.xml image.xml math.xml network.xml outcontrol.xml /ja/language references.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333202@lists.php.net to get a copy of this message
hirokawa Mon Dec 11 13:42:14 2000 EDT Modified files: /phpdoc/ja/functions funchand.xml gettext.xml ibase.xml image.xml math.xml network.xml outcontrol.xml /phpdoc/ja/language references.xml Log: update translation.

Index: phpdoc/ja/functions/funchand.xml diff -u phpdoc/ja/functions/funchand.xml:1.2 phpdoc/ja/functions/funchand.xml:1.3 --- phpdoc/ja/functions/funchand.xml:1.2 Sun Nov 26 04:47:20 2000 +++ phpdoc/ja/functions/funchand.xml Mon Dec 11 13:42:13 2000 @@ -355,7 +355,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>function_exists</function></funcdef> + <funcdef>bool <function>function_exists</function></funcdef> <paramdef>string <parameter>function_name</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -372,6 +372,8 @@ } </programlisting> </informalexample> + ある関数がそれ自体設定やコンパイルオプションの問題で使用できない + 場合でもその関数の名前が存在する可能性があることに注意して下さい。 </para> <para> <function>method_exists</function> も参照下さい。 Index: phpdoc/ja/functions/gettext.xml diff -u phpdoc/ja/functions/gettext.xml:1.3 phpdoc/ja/functions/gettext.xml:1.4 --- phpdoc/ja/functions/gettext.xml:1.3 Fri Aug 11 21:15:42 2000 +++ phpdoc/ja/functions/gettext.xml Mon Dec 11 13:42:13 2000 @@ -122,19 +122,16 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>textdomain</function></funcdef> - <paramdef>string - <parameter><optional>library</optional></parameter> - </paramdef> + <funcdef>string <function>textdomain</function></funcdef> + <paramdef>string <parameter>text_domain</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - この関数は、<function>gettext</function>がコールされた - 際に検索を行うドメインを設定します。 - このドメインは、通常、アプリケーション名が後に付きます。 - 前のデフォルトドメインが返されます。 - 現在のドメイン設定を変更せずに値を取得するには、 - 引数を指定せずにこの関数をコールして下さい。 + この関数は、<function>gettext</function>がコールされた際に検索を + 行うドメインを設定します。このドメインは、通常、アプリケーション + 名が後に付きます。前のデフォルトドメインが返されます。現在のドメ + イン設定を変更せずに値を取得するには、引数を指定せずにこの関数を + コールして下さい。 </para> </refsect1> </refentry> Index: phpdoc/ja/functions/ibase.xml diff -u phpdoc/ja/functions/ibase.xml:1.10 phpdoc/ja/functions/ibase.xml:1.11 --- phpdoc/ja/functions/ibase.xml:1.10 Sat Nov 4 04:12:24 2000 +++ phpdoc/ja/functions/ibase.xml Mon Dec 11 13:42:13 2000 @@ -330,6 +330,22 @@ select クエリが実行された後、フィールドに関する情報を配列として返 します。配列の要素には、name、alias、relation、length、type が含 まれます。 + <informalexample> + <programlisting role="php"> +// helio@helio.com.br 08-Dec-2000 02:53 + +$rs=ibase_query("Select * from something"); +$coln = ibase_num_fields($rs); +for ($i=0 ; $i < $coln ; $i++) { + $col_info = ibase_field_info($rs, $i); + echo "name: ".$col_info['name']."\n"; + echo "alias: ".$col_info['alias']."\n"; + echo "relation: ".$col_info['relation']."\n"; + echo "length: ".$col_info['length']."\n"; + echo "type: ".$col_info['type']."\n"; + } + </programlisting> + </informalexample> </para> </refsect1> </refentry> Index: phpdoc/ja/functions/image.xml diff -u phpdoc/ja/functions/image.xml:1.17 phpdoc/ja/functions/image.xml:1.18 --- phpdoc/ja/functions/image.xml:1.17 Thu Oct 26 15:19:21 2000 +++ phpdoc/ja/functions/image.xml Mon Dec 11 13:42:13 2000 @@ -1475,6 +1475,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>imagepsencodefont</function></funcdef> + <paramdef>int <parameter>font_index</parameter></paramdef> <paramdef>string <parameter>encodingfile</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1874,30 +1875,38 @@ </funcprototype> </funcsynopsis> <para> - 本関数はTrueTypeテキストのピクセル単位でのbounding boxを - 計算し返します。 + この関数はTrueTypeテキストのbounding boxをピクセル単位で計算して + 返します。 <variablelist> <varlistentry> - <term><parameter>text</parameter></term> + <term> + <parameter>text</parameter> + </term> <listitem> <simpara>測定する文字列。</simpara> </listitem> </varlistentry> <varlistentry> - <term><parameter>size</parameter></term> + <term> + <parameter>size</parameter> + </term> <listitem> - <simpara>フォントの大きさ。</simpara> + <simpara>ピクセル単位のフォントの大きさ。</simpara> </listitem> </varlistentry> <varlistentry> - <term><parameter>fontfile</parameter></term> + <term> + <parameter>fontfile</parameter> + </term> <listitem> <simpara>TrueTypeフォントファイルの名称。(URLも可。) </simpara> </listitem> </varlistentry> <varlistentry> - <term><parameter>angle</parameter></term> + <term> + <parameter>angle</parameter> + </term> <listitem> <simpara> 測定する<parameter>text</parameter>の角度(度単位)。 Index: phpdoc/ja/functions/math.xml diff -u phpdoc/ja/functions/math.xml:1.12 phpdoc/ja/functions/math.xml:1.13 --- phpdoc/ja/functions/math.xml:1.12 Sat Oct 14 06:26:33 2000 +++ phpdoc/ja/functions/math.xml Mon Dec 11 13:42:13 2000 @@ -315,10 +315,16 @@ <paramdef>float <parameter>number</parameter></paramdef> </funcprototype> </funcsynopsis> - <simpara> + <para> <parameter>number</parameter> の次に大きい整数を返します。整数に <function>ceil</function> を使うことは全くの時間の無駄です。 - </simpara> + <informalexample> + <programlisting role="php"> +$x = ceil(4.25); +// which would make $x=5 + </programlisting> + </informalexample> + </para> <note> <para> PHP/FI 2 での <function>ceil</function> は浮動小数 (float) を返 @@ -644,7 +650,7 @@ <para> 数値の 1 つ以上が倍精度実数の場合は、全ての数値が倍精度実数として 扱われ、倍精度実数で返されます。 - 数値に倍精度実数が全く無い場合、全ては整数として扱ã‚れ、 + 数値に倍精度実数が全く無い場合、全ては整数として扱ィ?、 整数を返します。 </para> </refsect1> Index: phpdoc/ja/functions/network.xml diff -u phpdoc/ja/functions/network.xml:1.15 phpdoc/ja/functions/network.xml:1.16 --- phpdoc/ja/functions/network.xml:1.15 Wed Oct 4 07:36:35 2000 +++ phpdoc/ja/functions/network.xml Mon Dec 11 13:42:13 2000 @@ -230,6 +230,12 @@ ?&gt; </programlisting> </example> + <note> + <para> + <parameter>timeout</parameter> は PHP 3.0.9 でサポートされまし + た。また、UDP のサポートは PHP 4で追加されました。 + </para> + </note> <function>pfsockopen</function>, <function>socket_set_blocking</function>, <function>socket_set_timeout</function>, <function>fgets</function>, Index: phpdoc/ja/functions/outcontrol.xml diff -u phpdoc/ja/functions/outcontrol.xml:1.4 phpdoc/ja/functions/outcontrol.xml:1.5 --- phpdoc/ja/functions/outcontrol.xml:1.4 Mon Nov 13 13:41:00 2000 +++ phpdoc/ja/functions/outcontrol.xml Mon Dec 11 13:42:13 2000 @@ -231,8 +231,8 @@ <para> この関数は、出力用バッファの内容を出力し、出力のバッファリングを オフにします。出力用バッファの内容を更に処理したい場合には、 - バッファの内容は出力の後に消去されるため、 - <function>ob_end_flush</function>の前に + バッファの内容は <function>ob_end_flush</function> がコールされた + 後に消去されるため、<function>ob_end_flush</function>の前に <function>ob_get_contents</function>をコールする必要があります。 </para> <para> Index: phpdoc/ja/language/references.xml diff -u phpdoc/ja/language/references.xml:1.2 phpdoc/ja/language/references.xml:1.3 --- phpdoc/ja/language/references.xml:1.2 Sat Aug 26 18:43:06 2000 +++ phpdoc/ja/language/references.xml Mon Dec 11 13:42:13 2000 @@ -37,6 +37,26 @@ </note> </para> <para> + 同じ構文は、リファレンスを返す関数や<literal>new</literal>演算子で + も使用可能です。(PHP 4.0.4 以降) + <informalexample> + <programlisting role="php"> +$bar =&amp; new fooclass(); +$foo =&amp; find_var ($bar); + </programlisting> + </informalexample> + </para> + <note> + <para> + 上記の構文を使用しない場合、<literal>$bar = new + fooclass()</literal> の結果は、コンストラクタの + <literal>$this</literal> と同じ変数にはなりません。このため、コン + ストラクタで <literal>$this</literal> へのリファレンスを使用する + 際には、リファレンスによる代入を使用するか、二つの異なったオブジェ + クトを取得する必要があります。 + </para> + </note> + <para> リファレンスの第2の使用法は、変数のリファレンス渡しです。この場合、 関数でローカル変数が作成され、コール側の変数と同じ内容へのリファレ ンスとなります。例を示します。 @@ -53,6 +73,8 @@ この結果、<varname>$a</varname> は 6となります。これは、関数 <varname>foo</varname>の中では、変数<varname>$var</varname>は <varname>$a</varname>と同じ内容を指しているためです。 + <link linkend="language.references.pass">リファレンス渡し</link> + に関するより詳細な説明も参照下さい。 </para> <simpara> リファレンスの第3の使用法は、 @@ -87,8 +109,80 @@ </simpara> </sect1> + <sect1 id="language.references.pass"> + <title>リファレンス渡し</title> + <para> + リファレンスにより関数に変数を渡すことが可能です。この場合、関数内 + でその引数を修正可能になります。構文は次のようになります。 + <informalexample> + <programlisting role="php"> +function foo (&amp;$var) { + $var++; +} + +$a=5; +foo ($a); +// $a はここでは 6 です + </programlisting> + </informalexample> + 関数コールの際には、リファレンス記号がないことに注意して下さい。関 + 数定義にのみリファレンス記号があります。リファレンスで正しく引数を + 渡すには、関数定義のみで十分です。 + </para> + <para> + 次のものはリファレンスで渡すことが可能です。 + <itemizedlist> + <listitem> + <simpara> + 変数、すなわち、<literal>foo($a)</literal> + </simpara> + </listitem> + <listitem> + <simpara> + new 命令、すなわち、<literal>foo(new foobar())</literal> + </simpara> + </listitem> + <listitem> + <para> + 関数から返されるリファレンスは、次のようになります。 + <informalexample> + <programlisting role="php"> +function &amp;bar() +{ + $a = 5; + return $a; +} +foo(bar()); + </programlisting> + </informalexample> + <link linkend="language.references.return">リファレンスによる返 + り値</link> に関する説明も参照下さい。 + </para> + </listitem> + </itemizedlist> + </para> + <para> + 他の式は、結果が未定義となるため、リファレンスで渡すべきではありま + せん。例えば、リファレンスで渡す次の例は、無効です。 + <informalexample> + <programlisting role="php"> +function bar() // &amp; がないことに注意 +{ + $a = 5; + return $a; +} +foo(bar); + +foo($a = 5) // 式、変数ではない +foo(5) // 定数、変数ではない + </programlisting> + </informalexample> + 以上の説明は、PHP 4.0.4 以降用です。 + </para> + </sect1> + <sect1 id="language.references.return"> - <title>リファレンスを返す</title> + <title>リファレンスによる返り値</title> <para> リファレンスを返すことは、結合する変数を見付けるために関数を使用し たい場合に便利です。リファレンスを返す場合、次の構文を使用して下さ
« previous php.doc (#969333202) next »