cvs: phpdoc /ja/functions info.xml java.xml math.xml pdf.xml printer.xml strings.xml xslt.xml yaz.xml

From: Date: Mon, 13 Aug 2001 08:11:40 +0000
Subject: cvs: phpdoc /ja/functions info.xml java.xml math.xml pdf.xml printer.xml strings.xml xslt.xml yaz.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969337053@lists.php.net to get a copy of this message
hirokawa Mon Aug 13 04:11:40 2001 EDT Modified files: /phpdoc/ja/functions info.xml java.xml math.xml pdf.xml printer.xml strings.xml xslt.xml yaz.xml Log: translation updated.

Index: phpdoc/ja/functions/info.xml diff -u phpdoc/ja/functions/info.xml:1.26 phpdoc/ja/functions/info.xml:1.27 --- phpdoc/ja/functions/info.xml:1.26 Sat Jul 7 18:25:46 2001 +++ phpdoc/ja/functions/info.xml Mon Aug 13 04:11:35 2001 @@ -39,7 +39,7 @@ <para> assersion は、入力パラメータのチェックのような通常の実行動作に使 用するべきではありません。一般的には、assertion のチェックが有効 - でない場合に自分のコード常に成城に動作することができる必要があり + でない場合に自分のコードを常に正常に動作することができる必要があり ます。 </para> <para> @@ -47,6 +47,52 @@ <function>assert_options</function> またはマニュアルの関数の部分 に記述された .ini の設定により設定することが可能です。 </para> + <para> + 関数 <function>assert_options</function> かつ/または + ASSERT_CALLBACK 設定ディレクティブにより失敗したassertionを + 処理するコールバック関数を設定することが可能です。 + </para> + <para> + <function>assert</function> のコールバックは、assertionが発生 + した場所に関する情報と共にassertionに渡されたコードを容易にキャ + プチャーできるため、特に自動テストセットを構築する際に便利です。 + この情報は他の手法でもキャプチャー可能ですが、assertionを使用 + することにより、より簡単かつ容易に行なうことが可能です! + </para> + <para> + コールバック関数は、3つの引数を受ける必要があります。最初の引数 + は、assertionが失敗したファイルが含まれます。2番目の引数には、 + assertionが失敗した行が含まれ、3番目の引数には失敗した式が含ま + れます。(もしある場合のみ。1または"two"のようなリテラルの値はこ + の引数に渡されません) + </para> + <para> + <example> + <title>カスタムハンドラで失敗したassertionを処理する</title> + <programlisting role="php"> +&lt;?php +// assertを有効にし、出力を抑制する +assert_options (ASSERT_ACTIVE, 1); +assert_options (ASSERT_WARNING, 0); +assert_options (ASSERT_QUIET_EVAL, 1); + +// ハンドラ関数を作成する +function my_assert_handler ($file, $line, $code) { + echo "&lt;hr&gt;Assertion Failed: + File '$file'&lt;br&gt; + Line '$line'&lt;br&gt; + Code '$code'&lt;br&gt;&lt;hr&gt;"; +} + +// コールバックを設定する +assert_options (ASSERT_CALLBACK, 'my_assert_handler'); + +// 失敗するassertionを作成 +assert ('mysql_query ("")'); +?&gt; + </programlisting> + </example> + </para> </refsect1> </refentry> @@ -720,7 +766,7 @@ <row> <entry>register_globals</entry> <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> + <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> <entry>safe_mode</entry> @@ -749,7 +795,7 @@ </row> <row> <entry>arg_separator</entry> - <entry>"&"</entry> + <entry>"&amp;"</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -1094,6 +1140,8 @@ <para> オプションのパラメータ <parameter>what</parameter> に以下の値を一 つまたは複数指定することにより出力をカスタマイズすることが可能です。 + (<link linkend="language.operators.bitwise">or</link>演算子により + これらを組み合わせることが可能です。) <itemizedlist> <listitem><simpara>INFO_GENERAL</simpara></listitem> <listitem><simpara>INFO_CREDITS</simpara></listitem> @@ -1256,15 +1304,35 @@ </funcprototype> </funcsynopsis> <para> - サーバーの環境変数に <parameter>setting</parameter> を追加します。この環境変数は、カレントのリクエストを実行している間のみ存在します。リクエスト終了時、環境変数は元の状態に戻されます。 - </para> - <para> - ある種の環境変数が変更されることは潜在的なセキュリティリスクとなる可能性があります。<literal>safe_mode_allowed_env_vars</literal> ディレクティブには接頭辞のカンマ区切りのリストが含まれます。セーフモードでは、ユーザはこのディレクティブで指定された接頭辞で始まる名前を有する環境変数のみを変更可能となります。 -デフォルトでは、ユーザは<literal>PHP_</literal> で始まる環境変数(例えば<literal>PHP_FOO=BAR</literal>)のみを変更可能です。注意:このディレクティブが空の場合、PHPはユーザに全ての環境変数を修正できる許可を与えてしまいます! - </para> - <para> - <literal>safe_mode_protected_env_vars</literal> ディレクティブには、カンマ区切りの環境変数のリストが含まれます。ユーザは、この環境変数を<function>putenv</function>により変更することができません。これらの変数は、<literal>safe_mode_allowed_env_vars</literal>が変更することを許可している場合でも保護されます。 + サーバーの環境変数に <parameter>setting</parameter> を追加します。 + この環境変数は、カレントのリクエストを実行している間のみ存在します。 + リクエスト終了時、環境変数は元の状態に戻されます。 + </para> + <para> + ある種の環境変数が変更されることは潜在的なセキュリティリスクとなる + 可能性があります。<literal>safe_mode_allowed_env_vars</literal> + ディレクティブには接頭辞のカンマ区切りのリストが含まれます。セーフ + モードでは、ユーザはこのディレクティブで指定された接頭辞で始まる名前 + を有する環境変数のみを変更可能となります。 + デフォルトでは、ユーザは<literal>PHP_</literal> で始まる環境変数 + (例えば<literal>PHP_FOO=BAR</literal>)のみを変更可能です。注意:この + ディレクティブが空の場合、PHPはユーザに全ての環境変数を修正できる許可 + を与えてしまいます! + </para> + <para> + <literal>safe_mode_protected_env_vars</literal> ディレクティブには、 + カンマ区切りの環境変数のリストが含まれます。ユーザは、この環境変数 + を<function>putenv</function>により変更することができません。これら + の変数は、<literal>safe_mode_allowed_env_vars</literal>が変更するこ + とを許可している場合でも保護されます。 </para> + <warning> + <para> + これらのディレクティブは、 + <link linkend="features.safe-mode">セーフモード</link> が有効な場合に + のみ効果があります! + </para> + </warning> <para> <example> <title>環境変数の設定</title> Index: phpdoc/ja/functions/java.xml diff -u phpdoc/ja/functions/java.xml:1.2 phpdoc/ja/functions/java.xml:1.3 --- phpdoc/ja/functions/java.xml:1.2 Sat Jul 7 18:25:48 2001 +++ phpdoc/ja/functions/java.xml Mon Aug 13 04:11:37 2001 @@ -3,36 +3,37 @@ <titleabbrev>PHP / Java の連携</titleabbrev> <partintro> <para> - PHPとJavaの連携をとして考えられる手段は2種類あります。JavaをPHPに統合 - する手法、この手法はより安定で効率的な手法です、または、PHPをJavaサー - ブレット環境に統合する手法です。前者は、ext/java で提供され、後者はサ - ーブレットサーバとのインターフェイスであるSAPIモジュールです。 + PHPとJavaの連携をとして考えられる手段は2種類あります。PHPをJavaサーブ + レット環境に統合する方法とJavaサポートをPHPに統合する方法です。前者の + 方がより安定で効率的な手法です。前者は、サーブレットサーバへのインター + フェイスとしてSAPIモジュールにより提供され、後者は、Java拡張モジュール + として提供されます。 </para> <para> PHP 4 ext/java は、PHPからJavaオブジェクトのメソッドを生成し、コール する簡単で効率的な手段を提供します。このJVMはJNIを用いて作成され、全 てはこのプロセスで動作します。ext/javaの構築手順は、 - php4/ext/java/README にあります。 + <filename>php4/ext/java/README</filename>にあります。 <example> <title>Java の例</title> <programlisting role="php"> &lt;?php // Java クラス java.lang.System のインスタンスをPHPに作成する - $system = new Java("java.lang.System"); + $system = new Java('java.lang.System'); // プロパティへのアクセスのデモ - print "Java version=".$system-&gt;getProperty("java.version")." &lt;br&gt;"; - print "Java vendor=" .$system-&gt;getProperty("java.vendor")." &lt;br&gt;"; - print "OS=".$system-&gt;getProperty("os.name")." ". - $system-&gt;getProperty("os.version")." on ". - $system-&gt;getProperty("os.arch")." &lt;br&gt;"; + print 'Java version='.$system-&gt;getProperty('java.version').' &lt;br&gt;'; + print 'Java vendor=' .$system-&gt;getProperty('java.vendor').' &lt;br&gt;'; + print 'OS='.$system-&gt;getProperty('os.name').' '. + $system-&gt;getProperty('os.version').' on '. + $system-&gt;getProperty('os.arch').' &lt;br&gt;'; // java.util.Date の例 - $formatter = new Java("java.text.SimpleDateFormat", + $formatter = new Java('java.text.SimpleDateFormat', "EEEE, MMMM dd, yyyy 'at' h:mm:ss a zzzz"); - print $formatter-&gt;format(new Java("java.util.Date")); + print $formatter-&gt;format(new Java('java.util.Date')); ?&gt; </programlisting> </example> @@ -42,15 +43,15 @@ &lt;?php // この例は、CGIとして実行されることのみを考慮しています。 - $frame = new Java("java.awt.Frame", "Zend"); - $button = new Java("java.awt.Button", "Hello Java world!"); + $frame = new Java('java.awt.Frame', 'PHP'); + $button = new Java('java.awt.Button', 'Hello Java world!'); $frame-&gt;add("North", $button); $frame-&gt;validate(); $frame-&gt;pack(); $frame-&gt;visible = True; - $thread = new Java("java.lang.Thread"); + $thread = new Java('java.lang.Thread'); $thread-&gt;sleep(10000); $frame-&gt;dispose(); @@ -63,26 +64,28 @@ <itemizedlist> <listitem> <simpara> - new Java() は、有効なコンストラクタある場合、クラスのインスタンス - を生成します。引数が指定されない場合には、デフォルトのコンストラ - クタにより"java.lang.System"のようなクラスにアクセスするとよいで - しょう。このクラスは、静的な手法でそのクラスの機能の多くを公開し - ています。 + <literal>new Java()</literal> は、有効なコンストラクタがある場合、 + クラスのインスタンスを生成します。引数が指定されない場合には、 + デフォルトのコンストラクタにより + <literal>java.lang.System</literal>のようなクラスにアクセスすると + 良いでしょう。このクラスは、静的な手法でそのクラスの機能の多くを + 公開しています。 </simpara> </listitem> <listitem> <simpara> あるインスタンスのメンバーにアクセスする際には、まずbeanプロパティ が探されてから、次にpublicフィールドが探されます。言い換えると、 - "print $date.time" はまず "$date.getTime()" と解釈され、続いて - "$date.time" と解釈されます。 + <literal>print $date.time</literal>はまず + <literal>$date.getTime()</literal>と解釈され、続いて + <literal>$date.time</literal>と解釈されます。 </simpara> </listitem> <listitem> <simpara> 静的メンバおよびインスタンスメンバは共に同じ構文でアクセス可能です。 - さらに、javaオブジェクトが"java.lang.Class"型の場合、このクラスの静 - 的メンバ(フィールドとメソッド)にアクセス可能です。 + さらに、javaオブジェクトが<literal>java.lang.Class</literal>型の場 + 合、このクラスの静的メンバ(フィールドとメソッド)にアクセス可能です。 </simpara> </listitem> <listitem> @@ -122,12 +125,12 @@ </itemizedlist> </para> <para> - PHP4 sapi/servlet はPHPプロセッサ全体をサーブレットとして実行するために - ext//javaにより定義された機構の上に構築されています。 + sapi/servlet はPHPプロセッサ全体をサーブレットとして実行するために + ext/javaにより定義された機構の上に構築されています。 この形態のPHPの側からこの実装が基本的に優れている点は、サーブレットを サポートするWebサーバが通常JVMをプールし、再利用することに注力している - ことです。このサーブレットSAPIモジュールの構築手順は、php4/sapi/README - にあります。 + ことです。このサーブレットSAPIモジュールの構築手順は、 + <filename>php4/sapi/README</filename> にあります。 注意: @@ -189,7 +192,7 @@ <title>Java例外ハンドラ</title> <programlisting role="php"> <?php - $stack = new Java("java.util.Stack"); + $stack = new Java('java.util.Stack'); $stack-&gt;push(1); // 以下のコードは実行に成功します @@ -203,7 +206,7 @@ if ($ex) print $ex->toString(); // 直近の例外をクリア - java_last_exception_clear(); + java_last_exception_clear();php4/sapi/README ?> </programlisting> </example> Index: phpdoc/ja/functions/math.xml diff -u phpdoc/ja/functions/math.xml:1.20 phpdoc/ja/functions/math.xml:1.21 --- phpdoc/ja/functions/math.xml:1.20 Sat Jun 23 16:35:13 2001 +++ phpdoc/ja/functions/math.xml Mon Aug 13 04:11:37 2001 @@ -1,7 +1,7 @@ <reference id="ref.math"> <title>数学関数</title> - <titleabbrev>Math.</titleabbrev> + <titleabbrev>Math</titleabbrev> <partintro> <sect1 id="math.intro"> @@ -295,8 +295,9 @@ ます。 </para> <para> - OctDec は、2進数 を 10進数に変換します。変換可能な最も大きな数字 - は 1 が 31 ビット並んだ 2進数 であり、10進数 の 2147483647 です。 + <function>bindec</function>は、2進数を<type>integer</type>に変換 + します。変換可能な最も大きな数字は 1 が 31 ビット並んだ 2進数で + あり、10進数の2147483647です。 </para> <para> <function>decbin</function> 関数も参照下さい。 @@ -503,7 +504,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>getrandmax</function></funcdef> - <paramdef>void </paramdef> + <paramdef>void</paramdef> </funcprototype> </funcsynopsis> @@ -563,7 +564,7 @@ <para> <function>lcg_value</function> は、(0, 1)の範囲の疑似乱数を返しま す。この関数は、周期が2^31 - 85および2^31 - 249の2つの CG を組み - 合わせます。この颦հの周期はこれら2つの素数の積と等価です。 + 合わせます。この関数の周期はこれら2つの素数の積と等価です。 </para> </refsect1> </refentry> @@ -811,9 +812,15 @@ <funcprototype> <funcdef>string <function>number_format</function></funcdef> <paramdef>float <parameter>number</parameter></paramdef> - <paramdef>int <parameter>decimals</parameter></paramdef> - <paramdef>string <parameter>dec_point</parameter></paramdef> - <paramdef>string <parameter>thousands_sep</parameter></paramdef> + <paramdef>int + <parameter><optional>decimals</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>dec_point</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>thousands_sep</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -840,24 +847,53 @@ えられた文字列を使い、小数部の前のドット(".")の代わりに <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> - 例えば、フランス語表記では通常小数点以下は2桁とし、カンマ(',')を - 小数部の区切り文字、スペースを1000の位毎の区切り文字として使用し - ます。これは、次のように行います。 - <informalexample> + <example> + <title><function>number_format</function> の例</title> + <para> + 例えば、フランス語表記では通常小数点以下は2桁とし、カンマ + (',')を小数部の区切り文字、スペース(' ')を1000の位毎の区切り + 文字として使用します。これは、次のように行います。 + </para> <programlisting role="php"> &lt;?php - $nombre = 1234.56; - // 英語表記 (デフォルト) - $english_format_number = number_format($nombre); - // 1,234.56 - // フランス語表記 - $nombre_format_francais = number_format($nombre, 2, ',', ' '); - // 1 234,56 + + $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 + ?&gt; </programlisting> - </informalexample> + </example> </para> + <note> + <para> + <function>sprintf</function>, + <function>printf</function> , <function>sscanf</function>も + 参照下さい。 + </para> + </note> </refsect1> </refentry> @@ -895,12 +931,22 @@ <funcsynopsis> <funcprototype> <funcdef>double <function>pi</function></funcdef> - <paramdef>void </paramdef> + <paramdef>void</paramdef> </funcprototype> </funcsynopsis> <simpara> 円周率の近似値を返します。 </simpara> + <para> + <informalexample> + <programlisting> + +echo pi(); +// 3.1415926535898 を出力します。 + + </programlisting> + </informalexample> + </para> </refsect1> </refentry> @@ -920,9 +966,36 @@ </funcsynopsis> <para> <parameter>base</parameter> の <parameter>exp</parameter> 乗を返 - します。これが計算できない場合、<function>exp</function>は、 - <literal>NAN</literal>を返します。 + します。可能な場合、この関数は、<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> Index: phpdoc/ja/functions/pdf.xml diff -u phpdoc/ja/functions/pdf.xml:1.25 phpdoc/ja/functions/pdf.xml:1.26 --- phpdoc/ja/functions/pdf.xml:1.25 Wed Jul 11 09:10:24 2001 +++ phpdoc/ja/functions/pdf.xml Mon Aug 13 04:11:37 2001 @@ -680,48 +680,54 @@ <refentry id="function.pdf-arc"> <refnamediv> <refname>pdf_arc</refname> - <refpurpose>円弧を描く</refpurpose> + <refpurpose>(反時計回りに)円弧を描く</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> <funcdef>void <function>pdf_arc</function></funcdef> - <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> - <paramdef>double <parameter>r</parameter></paramdef> - <paramdef>double <parameter>alpha</parameter></paramdef> - <paramdef>double <parameter>beta</parameter></paramdef> + <paramdef>resource <parameter>pdf object</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>r</parameter></paramdef> + <paramdef>float <parameter>alpha</parameter></paramdef> + <paramdef>float <parameter>beta</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 反時計周りにalpha度からbeta度まで円弧を描画します。 </para> + <para> + <function>pdf_arcn</function>も参照下さい。 + </para> </refsect1> </refentry> <refentry id="function.pdf-arcn"> <refnamediv> <refname>pdf_arcn</refname> - <refpurpose>円弧を描く</refpurpose> + <refpurpose>(時計回りに)円弧を描く</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> <funcdef>void <function>pdf_arc</function></funcdef> - <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> - <paramdef>double <parameter>r</parameter></paramdef> - <paramdef>double <parameter>alpha</parameter></paramdef> - <paramdef>double <parameter>beta</parameter></paramdef> + <paramdef>resource <parameter>pdf object</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>r</parameter></paramdef> + <paramdef>float <parameter>alpha</parameter></paramdef> + <paramdef>float <parameter>beta</parameter></paramdef> </funcprototype> </funcsynopsis> <para> alpha度からbeta度まで円弧を時計周りに描きます。 </para> + <para> + <function>pdf_arc</function>も参照下さい。 + </para> </refsect1> </refentry> @@ -1612,7 +1618,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_open</function></funcdef> + <funcdef>int <function>pdf_open_ccitt</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>int <parameter>width</parameter></paramdef> Index: phpdoc/ja/functions/printer.xml diff -u phpdoc/ja/functions/printer.xml:1.2 phpdoc/ja/functions/printer.xml:1.3 --- phpdoc/ja/functions/printer.xml:1.2 Sat Jul 7 18:26:07 2001 +++ phpdoc/ja/functions/printer.xml Mon Aug 13 04:11:37 2001 @@ -18,17 +18,24 @@ <funcsynopsis> <funcprototype> <funcdef>mixed <function>printer_open</function></funcdef> - <paramdef>[string <parameter>devicename</parameter>]</paramdef> + <paramdef>string + <parameter><optional>devicename</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - この関数は、プリンタ<parameter>devicename</parameter>への接続を試み、成功時にハンドル、失敗時に&false;を返します。 + この関数は、プリンタ<parameter>devicename</parameter>への接続を + 試み、成功時にハンドル、失敗時に&false;を返します。 </para> <para> - パラメータが指定されない場合、この関数はデフォルトのプリンタへの接続をオープンします。(php.iniにprinter.default_printerとして指定されていない場合は、PHPはデフォルトのプリンタの検出を試みます) + パラメータが指定されない場合、この関数はデフォルトのプリンタへ + の接続をオープンします。(<filename>php.ini</filename>に + <literal>printer.default_printer</literal>として指定されていな + い場合は、PHPはデフォルトのプリンタの検出を試みます) </para> <para> - <function>printer_open</function> は、デバイスコンテキストも開始します。 + <function>printer_open</function> は、デバイスコンテキストも + 開始します。 </para> <example> <title><function>printer_open</function> の例</title> @@ -142,8 +149,12 @@ <funcprototype> <funcdef>array <function>printer_list</function></funcdef> <paramdef>int <parameter>enumtype</parameter></paramdef> - <paramdef>[string <parameter>name</parameter></paramdef> - <paramdef>[int <parameter>level</parameter>]]</paramdef> + <paramdef>string + <parameter><optional>name</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>level</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -563,7 +574,9 @@ <funcprototype> <funcdef>bool <function>printer_start_doc</function></funcdef> <paramdef>resource <parameter>handle</parameter></paramdef> - <paramdef>[string <parameter>document</parameter>]</paramdef> + <paramdef>string + <parameter><optional>document</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -604,9 +617,9 @@ </funcprototype> </funcsynopsis> <para> - The function creates a new document in the printer spooler. A document - can contain multiple pages, it's used to schedule the print job in the - spooler. For an example see <function>printer_start_doc</function>. + Closes a new document in the printer spooler. The document + is now ready for printing. For an example see + <function>printer_start_doc</function>. <parameter>handle</parameter> must be a valid handle to a printer. </para> </refsect1> @@ -1032,9 +1045,20 @@ </simpara> </listitem> </itemizedlist> - <parameter>italic</parameter> can be &true; or &false;, and sets whether the font should be italic. - <parameter>underline</parameter> can be &true; or &false;, and sets whether the font should be underlined. - <parameter>strikeout</parameter> can be &true; or &false;, and sets whether the font should be striked out. + </para> + <para> + <parameter>italic</parameter> can be &true; or &false;, + and sets whether the font should be italic. + </para> + <para> + <parameter>underline</parameter> can be &true; or &false;, + and sets whether the font should be underlined. + </para> + <para> + <parameter>strikeout</parameter> can be &true; or &false;, + and sets whether the font should be striked out. + </para> + <para> <parameter>orientation</parameter> specifies a rotation. For an example see <function>printer_select_font</function>. </para> @@ -1411,7 +1435,7 @@ printer_start_doc($handle, "My Document"); printer_start_page($handle); -$pen = printer_create_pen(PRINTER_PEN_SOLID, 30, 000000"); +$pen = printer_create_pen(PRINTER_PEN_SOLID, 30, "000000"); printer_select_pen($handle, $pen); printer_draw_line($handle, 1, 10, 1000, 10); Index: phpdoc/ja/functions/strings.xml diff -u phpdoc/ja/functions/strings.xml:1.40 phpdoc/ja/functions/strings.xml:1.41 --- phpdoc/ja/functions/strings.xml:1.40 Fri Jul 13 13:17:52 2001 +++ phpdoc/ja/functions/strings.xml Mon Aug 13 04:11:37 2001 @@ -17,7 +17,7 @@ <refentry id="function.addcslashes"> <refnamediv> - <refname>AddCSlashes</refname> + <refname>addcslashes</refname> <refpurpose>C言語と同様にスラッシュで文字列をクォートする</refpurpose> </refnamediv> <refsect1> @@ -62,7 +62,7 @@ <refentry id="function.addslashes"> <refnamediv> - <refname>AddSlashes</refname> + <refname>addslashes</refname> <refpurpose>文字列をスラッシュでクォートする</refpurpose> </refnamediv> <refsect1> @@ -113,37 +113,19 @@ <refentry id="function.chop"> <refnamediv> <refname>chop</refname> - <refpurpose>最後尾のホワイトスペースを取り除く</refpurpose> + <refpurpose><function>rtrim</function>へのエイリアス</refpurpose> </refnamediv> <refsect1> <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>chop</function></funcdef> - <paramdef>string <parameter>str</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - パラメータである文字列から改行を含む最後尾のホワイトスペースを取り除いた - ものを返します。 - <example> - <title><function>chop</function>の例</title> - <programlisting role="php"> -$trimmed = chop ($line); - </programlisting> - </example> + この関数は、<function>rtrim</function>へのエイリアスです。 </para> <note> <para> - <function>chop</function> は、文字列から最後の文字を削除する - Perl の <parameter>chop()</parameter> 関数とは異なっています。 + <function>chop</function> は、文字列の末尾の文字を削除するPerlの + <literal>chop()</literal>関数とは異なっています。 </para> </note> - <para> - <function>trim</function>, <function>ltrim</function>, - <function>rtrim</function>, <function>chop</function> - も参照下さい。 - </para> </refsect1> </refentry> @@ -515,7 +497,7 @@ // しかし、次の例は動作します。 ($some_var) ? print('true'): print('false'); // print は関数 -echo ($some_var) ? 'true': 'false'; // 命令を変更 +echo $some_var ? 'true': 'false'; // 命令を変更 ?> </programlisting> </example> @@ -1287,6 +1269,7 @@ </refsect1> </refentry> + <!-- this section is nearly-identical to trim, ltrim and rtrim --> <refentry id="function.ltrim"> <refnamediv> <refname>ltrim</refname> @@ -1300,16 +1283,89 @@ <funcprototype> <funcdef>string <function>ltrim</function></funcdef> <paramdef>string <parameter>str</parameter></paramdef> + <paramdef>string + <parameter><optional>charlist</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> この関数は文字列の最初から空白文字を取り除き、 - 取り除かれた文字列を返します。現在のところ削除される空白文字は、 - "\n", "\r", "\t", "\v", "\0"および通常のスペースです。 + 取り除かれた文字列を返します。2番目のパラメータを指定しない場合、 + <function>ltrim</function>は以下の文字を削除します。 + <!-- sorted by importance. Printed 3 times: trim, ltrim, rtrim --> + <itemizedlist> + <listitem> + <simpara> + " " (<acronym>ASCII</acronym> <literal>32</literal> + (<literal>0x20</literal>)), 通常の空白。 + </simpara> + </listitem> + <listitem> + <simpara> + "\t" (<acronym>ASCII</acronym> <literal>9</literal> + (<literal>0x09</literal>)), タブ。 + </simpara> + </listitem> + <listitem> + <simpara> + "\n" (<acronym>ASCII</acronym> <literal>13</literal> + (<literal>0x0D</literal>)), 改行。 + </simpara> + </listitem> + <listitem> + <simpara> + "\r" (<acronym>ASCII</acronym> <literal>10</literal> + (<literal>0x0A</literal>)), リターン。 + </simpara> + </listitem> + <listitem> + <simpara> + "\0" (<acronym>ASCII</acronym> <literal>0</literal> + (<literal>0x00</literal>)), <literal>NUL</literal>バイト + </simpara> + </listitem> + <listitem> + <simpara> <!-- not \v, since not supported by PHP --> + "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> + (<literal>0x0B</literal>)), a <!-- TODO: -->. + </simpara> + </listitem> + </itemizedlist> </para> <para> - <function>chop</function>, <function>rtrim</function>, - <function>trim</function> も参照下さい。 + <parameter>charlist</parameter>パラメータにより、削除する + 文字を指定することも可能です。削除したい全ての文字をリストに + して下さい。<literal>..</literal>を文字の範囲を指定する際に + 使用可能です。 + </para> + <example> + <title><function>ltrim</function>の使用例</title> + <para> + <programlisting role="php"> +<![CDATA[ +<?php + +$text = "\t\tThese are a few words :) ... "; +$trimmed = ltrim($text); +// $trimmed = "These are a few words :) ... " +$trimmed = ltrim($text," \t."); +// $trimmed = "These are a few words :) ... " +$clean = ltrim($binary,"\0x00..\0x1F"); +// $binaryの始めにあるASCII制御文字(0から31まで)を削除 + +?> +]]> + </programlisting> + </para> + </example> + <note> + <simpara> + 2番目のパラメータは、PHP 4.0.7で追加されました。 + </simpara> + </note> + <para> + <function>trim</function> および <function>rtrim</function>も + 参照下さい。 </para> </refsect1> </refentry> @@ -1585,10 +1641,11 @@ </refsect1> </refentry> + <!-- this section is nearly-identical to trim, ltrim and rtrim --> <refentry id="function.rtrim"> <refnamediv> <refname>rtrim</refname> - <refpurpose>終端の空白文字を削除する</refpurpose> + <refpurpose>文字列の最後から空白文字を削除する</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -1596,21 +1653,89 @@ <funcprototype> <funcdef>string <function>rtrim</function></funcdef> <paramdef>string <parameter>str</parameter></paramdef> + <paramdef>string + <parameter><optional>charlist</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - 引数の文字列から改行を含む終端の空白文字を削除して返します。 - この関数は、<function>chop</function>のエイリアスです。 - <example> - <title><function>rtrim</function> の例</title> + この関数は文字列の最後から空白文字を取り除き、 + 取り除かれた文字列を返します。2番目のパラメータを指定しない場合、 + <function>rtrim</function>は以下の文字を削除します。 + <!-- sorted by importance. Printed 3 times: trim, ltrim, rtrim --> + <itemizedlist> + <listitem> + <simpara> + " " (<acronym>ASCII</acronym> <literal>32</literal> + (<literal>0x20</literal>)), 通常の空白。 + </simpara> + </listitem> + <listitem> + <simpara> + "\t" (<acronym>ASCII</acronym> <literal>9</literal> + (<literal>0x09</literal>)), タブ。 + </simpara> + </listitem> + <listitem> + <simpara> + "\n" (<acronym>ASCII</acronym> <literal>13</literal> + (<literal>0x0D</literal>)), 改行。 + </simpara> + </listitem> + <listitem> + <simpara> + "\r" (<acronym>ASCII</acronym> <literal>10</literal> + (<literal>0x0A</literal>)), リターン。 + </simpara> + </listitem> + <listitem> + <simpara> + "\0" (<acronym>ASCII</acronym> <literal>0</literal> + (<literal>0x00</literal>)), <literal>NUL</literal>バイト + </simpara> + </listitem> + <listitem> + <simpara> <!-- not \v, since not supported by PHP --> + "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> + (<literal>0x0B</literal>)), a <!-- TODO: -->. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <parameter>charlist</parameter>パラメータにより、削除する + 文字を指定することも可能です。削除したい全ての文字をリストに + して下さい。<literal>..</literal>を文字の範囲を指定する際に + 使用可能です。 + </para> + <example> + <title><function>rtrim</function>の使用例</title> + <para> <programlisting role="php"> -$trimmed = rtrim ($line); +<![CDATA[ +<?php + +$text = "\t\tThese are a few words :) ... "; +$trimmed = rtrim($text); +// $trimmed = "\t\tThese are a few words :) ... " +$trimmed = rtrim($text," \t."); +// $trimmed = "\t\tThese are a few words :)" +$clean = rtrim($binary,"\0x00..\0x1F"); +// $binaryの最後にあるASCII制御文字(0から31まで)を削除 + +?> +]]> </programlisting> - </example> - </para> + </para> + </example> + <note> + <simpara> + 2番目のパラメータは、PHP 4.0.7で追加されました。 + </simpara> + </note> <para> - <function>trim</function>, <function>ltrim</function>, - <function>rtrim</function>も参照下さい。 + <function>trim</function> および <function>ltrim</function>も + 参照下さい。 </para> </refsect1> </refentry> @@ -2950,14 +3075,13 @@ </funcprototype> </funcsynopsis> <para> - <parameter>string</parameter> を、アルファベット部分を + <parameter>string</parameter> をアルファベット部分を すべて小文字にして返します。 </para> <para> 「アルファベット部分」は現在のロケールにより決定されます。 このため、たとえばデフォルトの "C" ロケールである場合は、 - ウムラウトA (訳注:日本語文字セットでは表示できない文字のため省略) - のような文字は変換されません。 + ウムラウトA (&Auml;) のような文字は変換されません。 </para> <example> <title><function>strtolower</function>の例</title> @@ -3339,6 +3463,7 @@ </refsect1> </refentry> + <!-- this section is nearly-identical to trim, ltrim and rtrim --> <refentry id="function.trim"> <refnamediv> <refname>trim</refname> @@ -3352,17 +3477,89 @@ <funcprototype> <funcdef>string <function>trim</function></funcdef> <paramdef>string <parameter>str</parameter></paramdef> + <paramdef>string + <parameter><optional>charlist</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - この関数は、文字列の先頭および末尾にあるホワイトスペースを - 取り除き、その結果の文字列を返します。 - 現在のところ取り除かれるホワイトスペース文字は - "\n"、"\r"、"\t"、"\v"、"\0"および通常のスペース(空白)です。 + この関数は文字列の最初および最後から空白文字を取り除き、 + 取り除かれた文字列を返します。2番目のパラメータを指定しない場合、 + <function>trim</function>は以下の文字を削除します。 + <!-- sorted by importance. Printed 3 times: trim, ltrim, rtrim --> + <itemizedlist> + <listitem> + <simpara> + " " (<acronym>ASCII</acronym> <literal>32</literal> + (<literal>0x20</literal>)), 通常の空白。 + </simpara> + </listitem> + <listitem> + <simpara> + "\t" (<acronym>ASCII</acronym> <literal>9</literal> + (<literal>0x09</literal>)), タブ。 + </simpara> + </listitem> + <listitem> + <simpara> + "\n" (<acronym>ASCII</acronym> <literal>13</literal> + (<literal>0x0D</literal>)), 改行。 + </simpara> + </listitem> + <listitem> + <simpara> + "\r" (<acronym>ASCII</acronym> <literal>10</literal> + (<literal>0x0A</literal>)), リターン。 + </simpara> + </listitem> + <listitem> + <simpara> + "\0" (<acronym>ASCII</acronym> <literal>0</literal> + (<literal>0x00</literal>)), <literal>NUL</literal>バイト + </simpara> + </listitem> + <listitem> + <simpara> <!-- not \v, since not supported by PHP --> + "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> + (<literal>0x0B</literal>)), a <!-- TODO: -->. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <parameter>charlist</parameter>パラメータにより、削除する + 文字を指定することも可能です。削除したい全ての文字をリストに + して下さい。<literal>..</literal>を文字の範囲を指定する際に + 使用可能です。 </para> + <example> + <title><function>trim</function>の使用例</title> + <para> + <programlisting role="php"> +<![CDATA[ +<?php + +$text = "\t\tThese are a few words :) ... "; +$trimmed = trim($text); +// $trimmed = "These are a few words :) ... " +$trimmed = trim($text," \t."); +// $trimmed = "These are a few words :)" +$clean = trim($binary,"\0x00..\0x1F"); +// $binaryの始めおよび最後にあるASCII制御文字(0から31まで)を削除 + +?> +]]> + </programlisting> + </para> + </example> + <note> + <simpara> + 2番目のパラメータは、PHP 4.0.7で追加されました。 + </simpara> + </note> <para> - <function>chop</function>, <function>rtrim</function>, - <function>ltrim</function>も参照下さい。 + <function>ltrim</function> および <function>rtrim</function>も + 参照下さい。 </para> </refsect1> </refentry> @@ -3389,7 +3586,7 @@ <para> 「アルファベット」かどうかというのは現在のロケールにより決定 されます。たとえば、デフォルトの "C" ロケールでは、ウムラウトa - (訳注:日本語文字セットの非表示文字のため省略)は変換されません。 + (&auml;)は変換されません。 <example> <title><function>ucfirst</function>の例</title> <programlisting role="php"> Index: phpdoc/ja/functions/xslt.xml diff -u phpdoc/ja/functions/xslt.xml:1.8 phpdoc/ja/functions/xslt.xml:1.9 --- phpdoc/ja/functions/xslt.xml:1.8 Sun Jul 8 09:01:33 2001 +++ phpdoc/ja/functions/xslt.xml Mon Aug 13 04:11:39 2001 @@ -67,6 +67,7 @@ <paramdef>resource <parameter>xh</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> <variablelist> <varlistentry> @@ -100,6 +101,7 @@ <void/> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> この関数は、新規のXSLTプロセッサへのハンドルを返します。このハン ドルは、この後に使用する全てのXSLT関数をコールする際に必要です。 @@ -117,13 +119,10 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>xslt_errno</function></funcdef> - <paramdef>int - <parameter> - <replaceable><optional>xh</optional></replaceable> - </parameter> - </paramdef> + <paramdef>resource <parameter>xh</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> 指定したXSLTプロセッサについてカレントのエラー番号を返します。ハ ンドルが指定されていない場合、どこかで発生した直近のエラー番号が @@ -142,13 +141,10 @@ <funcsynopsis> <funcprototype> <funcdef>mixed <function>xslt_error</function></funcdef> - <paramdef>int - <parameter> - <replaceable><optional>xh</optional></replaceable> - </parameter> - </paramdef> + <paramdef>resource <parameter>xh</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> 指定したXSLTプロセッサについてカレントのエラー文字列を返します。 ハンドラが指定されない場合、どこかで発生した直近のエラー文字列が @@ -167,14 +163,11 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>xslt_fetch_result</function></funcdef> - <paramdef><parameter>int xh</parameter></paramdef> - <paramdef> - <parameter>string - <replaceable><optional>result_name</optional></replaceable> - </parameter> - </paramdef> + <paramdef>resource <parameter>xh</parameter></paramdef> + <paramdef>string <parameter>result_name</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> ハンドルにより指定したXSLTプロセッサから結果バッファを取得します。 <parameter>result_name</parameter> が指定されない場合、 @@ -193,11 +186,10 @@ <funcsynopsis> <funcprototype> <funcdef>void <function>xslt_free</function></funcdef> - <paramdef> - <parameter>resource xh</parameter> - </paramdef> + <paramdef>resource <parameter>xh</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> ハンドルで指定したXSLTプロセッサを開放します。 </para> @@ -216,19 +208,12 @@ <funcsynopsis> <funcprototype> <funcdef>bool <function>xslt_openlog</function></funcdef> - <paramdef> - <parameter>resource xh</parameter> - </paramdef> - <paramdef> - <parameter>string logfile</parameter> - </paramdef> - <paramdef> - <parameter> - <replaceable><optional>int loglevel</optional></replaceable> - </parameter> - </paramdef> + <paramdef>resource <parameter>xh</parameter></paramdef> + <paramdef>string <parameter>logfile</parameter></paramdef> + <paramdef>int <parameter>loglevel</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> XSLT プロセッサのエラーメッセージを全て記録するログファイルを設定 します。 @@ -248,11 +233,10 @@ <funcdef>void <function>xslt_output_begintransform</function> </funcdef> - <paramdef> - <parameter>string xslt_filename</parameter> - </paramdef> + <paramdef>string <parameter>xslt_filename</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> この関数は、データ出力の変換を開始します。 <function>xslt_output_begintransform</function> をコールした場所 @@ -307,6 +291,7 @@ <void/> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> <function>xslt_output_endtransform</function> は、 <function>xslt_output_begintransform</function> 関数で開始した出力の変換を @@ -328,13 +313,12 @@ <funcdef>bool <function>xslt_process</function> </funcdef> - <paramdef> - <parameter>string xsl_data</parameter> - <parameter>string xml_data</parameter> - <parameter>string result</parameter> - </paramdef> + <paramdef>string <parameter>xsl_data</parameter></paramdef> + <paramdef>string <parameter>xml_data</parameter></paramdef> + <paramdef>string <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> <function>xslt_process</function> は、XSLT スタイルシートを有する 文字列を最初の引数、変換したいXMLデータを有する文字列を2番目の引 @@ -361,7 +345,7 @@ &lt;table border="1" cellpadding="2" cellspacing="1"&gt; &lt;tr&gt; &lt;td width="20%"&gt; - &amp#160; + &amp;#160; &lt;/td&gt; &lt;td width="80%"&gt; &lt;h2&gt;&lt;xsl:value-of select="title"/&gt;&lt;/h2&gt; @@ -417,26 +401,15 @@ <funcsynopsis> <funcprototype> <funcdef>bool <function>xslt_run</function></funcdef> - <paramdef><parameter>resource xh</parameter></paramdef> - <paramdef><parameter>string xslt_file</parameter></paramdef> - <paramdef><parameter>string xml_data_file</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional>string result</optional></replaceable> - </parameter> - </paramdef> - <paramdef> - <parameter> - <replaceable><optional>array xslt_params</optional></replaceable> - </parameter> - </paramdef> - <paramdef> - <parameter> - <replaceable><optional>array xslt_args</optional></replaceable> - </parameter> - </paramdef> + <paramdef>resource <parameter>xh</parameter></paramdef> + <paramdef>string <parameter>xslt_file</parameter></paramdef> + <paramdef>string <parameter>xml_data_file</parameter></paramdef> + <paramdef>string <parameter>result</parameter></paramdef> + <paramdef>array <parameter>xslt_params</parameter></paramdef> + <paramdef>array <parameter>xslt_args</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> xslt_file スタイルシートを適用することにより xml_data_file を処理 する。スタイルシートは xslt_params にアクセスし、プロセッサは @@ -456,14 +429,14 @@ <funcsynopsis> <funcprototype> <funcdef>bool <function>xslt_set_sax_handler</function></funcdef> - <paramdef> - <parameter>resource xh</parameter> - <parameter>array handlers</parameter> - </paramdef> + <paramdef>resource <parameter>xh</parameter></paramdef> + <paramdef>array <parameter>handlers</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> - xh で指定したリソースハンドルに SAX ハンドラを設定します。 + <parameter>xh</parameter>で指定したリソースハンドルにSAX ハンドラ + を設定します。 </para> </refsect1> </refentry> @@ -480,16 +453,15 @@ <funcdef>bool <function>xslt_transform</function> </funcdef> - <paramdef> - <parameter>string xsl</parameter> - <parameter>string xml</parameter> - <parameter>string result</parameter> - <parameter>string params</parameter> - <parameter>string args</parameter> - <parameter>string resultBuffer</parameter> - </paramdef> + <paramdef>string <parameter>xsl</parameter></paramdef> + <paramdef>string <parameter>xml</parameter></paramdef> + <paramdef>string <parameter>result</parameter></paramdef> + <paramdef>string <parameter>params</parameter></paramdef> + <paramdef>string <parameter>args</parameter></paramdef> + <paramdef>string <parameter>resultBuffer</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> <function>xslt_transform</function> は、リソースAPIを使用すること なく、Sablotron のより高度な機能へのインターフェースを提供します。 Index: phpdoc/ja/functions/yaz.xml diff -u phpdoc/ja/functions/yaz.xml:1.7 phpdoc/ja/functions/yaz.xml:1.8 --- phpdoc/ja/functions/yaz.xml:1.7 Sat Jul 7 18:26:19 2001 +++ phpdoc/ja/functions/yaz.xml Mon Aug 13 04:11:39 2001 @@ -31,9 +31,9 @@ <sect1 id="yaz.install"> <title>インストール</title> <para> - YAZをコンパイルし、インストールして下さい。PHPをオプション-- - with-yazを付けて他の任意のモジュールとコンパイルして下さい。この - 手順の概要を以下に示します。 + YAZをコンパイルし、インストールして下さい。PHPをオプション + <literal>--with-yaz</literal>を付けて他の任意のモジュールと + コンパイルして下さい。この手順の概要を以下に示します。 </para> <para> <informalexample> @@ -181,8 +181,8 @@ <funcprototype> <funcdef>int <function>yaz_connect</function></funcdef> <paramdef>string <parameter>zurl</parameter></paramdef> - <paramdef>string - <parameter><optional>authentication</optional></parameter> + <paramdef>mixed + <parameter><optional>options</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -195,6 +195,59 @@ <function>yaz_wait</function>がコールされた際に接続を実行する準備 を行うだけです。 </para> + <para> + 2番目の引数、<parameter>options</parameter>に文字列が指定された場合、 + Z39.50 V2認証文字列(OpenAuth)として処理されます。 + </para> + <para> + <parameter>options</parameter> に配列が指定された場合、その配列の内 + 容はオプションとして処理されます。配列オプションは、PHP 4.0.7以降 + でのみサポートされることに注意して下さい。 + + <variablelist> + <title><function>yaz_connect</function> オプション</title> + <varlistentry><term>user</term><listitem> + <simpara>認証用のユーザ名 + </simpara></listitem> + </varlistentry> + <varlistentry><term>group</term><listitem> + <simpara>認証用のグループ + </simpara></listitem> + </varlistentry> + <varlistentry><term>password</term><listitem> + <simpara>認証用のパスワード + </simpara></listitem> + </varlistentry> + <varlistentry><term>cookie</term><listitem> + <simpara>セッションクッキー (YAZ proxy). + </simpara></listitem> + </varlistentry> + <varlistentry><term>proxy</term><listitem> + <simpara>接続用プロキシ (YAZ proxy). + </simpara></listitem> + </varlistentry> + <varlistentry><term>persistent</term><listitem> + <simpara> + 論理値。&true; の場合、接続は持続的となります。&false; の + 場合、接続は持続的ではありません。デフォルトで、接続は + 持続的です。 + </simpara> + </listitem> + </varlistentry> + <varlistentry><term>piggyback</term><listitem> + <simpara> + 論理値。&true; の場合、検索時のpiggybackが有効になります。 + &false; の場合、piggybackが無効になります。デフォルトでは、 + piggyback は有効です。piggybackを有効にするとより効率的となり、 + 通常、レコードを最初に取得する際のネットワーク往復時間を節約 + することが可能です。しかし、少数の Z39.50ターゲットは + piggybackをサポートしていないか、エレメント集合名を無視します。 + この場合、piggybackを無効とする必要があります。 + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> </refsect1> </refentry> @@ -446,37 +499,36 @@ </row> </tbody> </tgroup> - </table> - <para> - 以下は、有効なクエリ構造を説明するものです。 - <informalexample> + </table> + <example> + <title>クエリの例</title> + <para> + クエリ <screen>computer</screen> - </informalexample> - "computer" がある文書にマッチします。属性は指定されてません。 - </para> - <para> - <informalexample> + は、"computer"を含む文書にマッチします。属性は指定されていません。 + </para> + <para> + クエリ <screen>"donald knuth"</screen> - </informalexample> - "donald knuth" がある文書にマッチします。 - </para> - <para> - <informalexample> - <screen>@attr 1=4 art</screen> - </informalexample> - 属性型は1 (Bib-1 使用)で、属性値は 4(タイトル)です。これにより、 - "art"がタイトルにある文書にマッチします。 - </para> - <para> - <informalexample> + は、"donald knuth" がある文書にマッチします。 + </para> + <para> + クエリ + <screen>@attr 1=4 art</screen>の場合、 + 属性型は1 (Bib-1 use)、属性の値は4 (Title)となります。このため、 + titleに<literal>art</literal>が現れる文書にマッチします。 + </para> + <para> + その他のより複雑なクエリの例: <screen>@attrset gils @and @attr 1=4 art @attr 1=1003 "donald knuth"</screen> - </informalexample> - このクエリは全体にGILS属性セットを使用します。このクエリはtitleに - "art"があり、authorに"donald knuth"がある文書にマッチします。 - </para> + このクエリは、GILS属性集合を使用しています。クエリはtitleに + <literal>art</literal>が現れ、authorに<literal>donald knuth</literal> + が現れる文書にマッチします。 + </para> + </example> </refsect1> </refentry> - + <refentry id="function.yaz-present"> <refnamediv> <refname>yaz_present</refname> @@ -850,7 +902,9 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>yaz_wait</function></funcdef> - <void></void> + <paramdef> + <parameter><optional>array options</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -862,6 +916,21 @@ トが全てのリクエストを完了したか、(エラーの場合には)中断された場 合に処理を戻します。 </para> + <para> + 配列 <parameter>options</parameter> が指定された場合、 + <function>yaz_wait</function>の動作を変更するオプションとなります。 + </para> + <variablelist> + <varlistentry><term><literal>timeout</literal></term> + <listitem> + <para> + 時間のタイムアウトを設定します。ターゲットが時間内に応答しなかっ + た場合、動作していないとみなされ、<function>yaz_wait</function> + は帰ります。タイムアウトのデフォルト値は15sです。 + </para> + </listitem> + </varlistentry> + </variablelist> </refsect1> </refentry>
« previous php.doc (#969337053) next »