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 @@ assersion は、入力パラメータのチェックのような通常の実行動作に使 用するべきではありません。一般的には、assertion のチェックが有効 - でない場合に自分のコード常に成城に動作することができる必要があり + でない場合に自分のコードを常に正常に動作することができる必要があり ます。 @@ -47,6 +47,52 @@ assert_options またはマニュアルの関数の部分 に記述された .ini の設定により設定することが可能です。 + + 関数 assert_options かつ/または + ASSERT_CALLBACK 設定ディレクティブにより失敗したassertionを + 処理するコールバック関数を設定することが可能です。 + + + assert のコールバックは、assertionが発生 + した場所に関する情報と共にassertionに渡されたコードを容易にキャ + プチャーできるため、特に自動テストセットを構築する際に便利です。 + この情報は他の手法でもキャプチャー可能ですが、assertionを使用 + することにより、より簡単かつ容易に行なうことが可能です! + + + コールバック関数は、3つの引数を受ける必要があります。最初の引数 + は、assertionが失敗したファイルが含まれます。2番目の引数には、 + assertionが失敗した行が含まれ、3番目の引数には失敗した式が含ま + れます。(もしある場合のみ。1または"two"のようなリテラルの値はこ + の引数に渡されません) + + + + カスタムハンドラで失敗したassertionを処理する + +<?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 "<hr>Assertion Failed: + File '$file'<br> + Line '$line'<br> + Code '$code'<br><hr>"; +} + +// コールバックを設定する +assert_options (ASSERT_CALLBACK, 'my_assert_handler'); + +// 失敗するassertionを作成 +assert ('mysql_query ("")'); +?> + + + @@ -720,7 +766,7 @@ register_globals "1" - PHP_INI_ALL + PHP_INI_PERDIR|PHP_INI_SYSTEM safe_mode @@ -749,7 +795,7 @@ arg_separator - "&" + "&" PHP_INI_ALL @@ -1094,6 +1140,8 @@ オプションのパラメータ what に以下の値を一 つまたは複数指定することにより出力をカスタマイズすることが可能です。 + (or演算子により + これらを組み合わせることが可能です。) INFO_GENERAL INFO_CREDITS @@ -1256,15 +1304,35 @@ - サーバーの環境変数に setting を追加します。この環境変数は、カレントのリクエストを実行している間のみ存在します。リクエスト終了時、環境変数は元の状態に戻されます。 - - - ある種の環境変数が変更されることは潜在的なセキュリティリスクとなる可能性があります。safe_mode_allowed_env_vars ディレクティブには接頭辞のカンマ区切りのリストが含まれます。セーフモードでは、ユーザはこのディレクティブで指定された接頭辞で始まる名前を有する環境変数のみを変更可能となります。 -デフォルトでは、ユーザはPHP_ で始まる環境変数(例えばPHP_FOO=BAR)のみを変更可能です。注意:このディレクティブが空の場合、PHPはユーザに全ての環境変数を修正できる許可を与えてしまいます! - - - safe_mode_protected_env_vars ディレクティブには、カンマ区切りの環境変数のリストが含まれます。ユーザは、この環境変数をputenvにより変更することができません。これらの変数は、safe_mode_allowed_env_varsが変更することを許可している場合でも保護されます。 + サーバーの環境変数に setting を追加します。 + この環境変数は、カレントのリクエストを実行している間のみ存在します。 + リクエスト終了時、環境変数は元の状態に戻されます。 + + + ある種の環境変数が変更されることは潜在的なセキュリティリスクとなる + 可能性があります。safe_mode_allowed_env_vars + ディレクティブには接頭辞のカンマ区切りのリストが含まれます。セーフ + モードでは、ユーザはこのディレクティブで指定された接頭辞で始まる名前 + を有する環境変数のみを変更可能となります。 + デフォルトでは、ユーザはPHP_ で始まる環境変数 + (例えばPHP_FOO=BAR)のみを変更可能です。注意:この + ディレクティブが空の場合、PHPはユーザに全ての環境変数を修正できる許可 + を与えてしまいます! + + + safe_mode_protected_env_vars ディレクティブには、 + カンマ区切りの環境変数のリストが含まれます。ユーザは、この環境変数 + をputenvにより変更することができません。これら + の変数は、safe_mode_allowed_env_varsが変更するこ + とを許可している場合でも保護されます。 + + + これらのディレクティブは、 + セーフモード が有効な場合に + のみ効果があります! + + 環境変数の設定 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 @@ PHP / Java の連携 - PHPとJavaの連携をとして考えられる手段は2種類あります。JavaをPHPに統合 - する手法、この手法はより安定で効率的な手法です、または、PHPをJavaサー - ブレット環境に統合する手法です。前者は、ext/java で提供され、後者はサ - ーブレットサーバとのインターフェイスであるSAPIモジュールです。 + PHPとJavaの連携をとして考えられる手段は2種類あります。PHPをJavaサーブ + レット環境に統合する方法とJavaサポートをPHPに統合する方法です。前者の + 方がより安定で効率的な手法です。前者は、サーブレットサーバへのインター + フェイスとしてSAPIモジュールにより提供され、後者は、Java拡張モジュール + として提供されます。 PHP 4 ext/java は、PHPからJavaオブジェクトのメソッドを生成し、コール する簡単で効率的な手段を提供します。このJVMはJNIを用いて作成され、全 てはこのプロセスで動作します。ext/javaの構築手順は、 - php4/ext/java/README にあります。 + php4/ext/java/READMEにあります。 Java の例 <?php // Java クラス java.lang.System のインスタンスをPHPに作成する - $system = new Java("java.lang.System"); + $system = new Java('java.lang.System'); // プロパティへのアクセスのデモ - print "Java version=".$system->getProperty("java.version")." <br>"; - print "Java vendor=" .$system->getProperty("java.vendor")." <br>"; - print "OS=".$system->getProperty("os.name")." ". - $system->getProperty("os.version")." on ". - $system->getProperty("os.arch")." <br>"; + print 'Java version='.$system->getProperty('java.version').' <br>'; + print 'Java vendor=' .$system->getProperty('java.vendor').' <br>'; + print 'OS='.$system->getProperty('os.name').' '. + $system->getProperty('os.version').' on '. + $system->getProperty('os.arch').' <br>'; // 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->format(new Java("java.util.Date")); + print $formatter->format(new Java('java.util.Date')); ?> @@ -42,15 +43,15 @@ <?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->add("North", $button); $frame->validate(); $frame->pack(); $frame->visible = True; - $thread = new Java("java.lang.Thread"); + $thread = new Java('java.lang.Thread'); $thread->sleep(10000); $frame->dispose(); @@ -63,26 +64,28 @@ - new Java() は、有効なコンストラクタある場合、クラスのインスタンス - を生成します。引数が指定されない場合には、デフォルトのコンストラ - クタにより"java.lang.System"のようなクラスにアクセスするとよいで - しょう。このクラスは、静的な手法でそのクラスの機能の多くを公開し - ています。 + new Java() は、有効なコンストラクタがある場合、 + クラスのインスタンスを生成します。引数が指定されない場合には、 + デフォルトのコンストラクタにより + java.lang.Systemのようなクラスにアクセスすると + 良いでしょう。このクラスは、静的な手法でそのクラスの機能の多くを + 公開しています。 あるインスタンスのメンバーにアクセスする際には、まずbeanプロパティ が探されてから、次にpublicフィールドが探されます。言い換えると、 - "print $date.time" はまず "$date.getTime()" と解釈され、続いて - "$date.time" と解釈されます。 + print $date.timeはまず + $date.getTime()と解釈され、続いて + $date.timeと解釈されます。 静的メンバおよびインスタンスメンバは共に同じ構文でアクセス可能です。 - さらに、javaオブジェクトが"java.lang.Class"型の場合、このクラスの静 - 的メンバ(フィールドとメソッド)にアクセス可能です。 + さらに、javaオブジェクトがjava.lang.Class型の場 + 合、このクラスの静的メンバ(フィールドとメソッド)にアクセス可能です。 @@ -122,12 +125,12 @@ - PHP4 sapi/servlet はPHPプロセッサ全体をサーブレットとして実行するために - ext//javaにより定義された機構の上に構築されています。 + sapi/servlet はPHPプロセッサ全体をサーブレットとして実行するために + ext/javaにより定義された機構の上に構築されています。 この形態のPHPの側からこの実装が基本的に優れている点は、サーブレットを サポートするWebサーバが通常JVMをプールし、再利用することに注力している - ことです。このサーブレットSAPIモジュールの構築手順は、php4/sapi/README - にあります。 + ことです。このサーブレットSAPIモジュールの構築手順は、 + php4/sapi/README にあります。 注意: @@ -189,7 +192,7 @@ Java例外ハンドラ toString(); // 直近の例外をクリア - java_last_exception_clear(); + java_last_exception_clear();php4/sapi/README ?> 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 @@ 数学関数 - Math. + Math @@ -295,8 +295,9 @@ ます。 - OctDec は、2進数 を 10進数に変換します。変換可能な最も大きな数字 - は 1 が 31 ビット並んだ 2進数 であり、10進数 の 2147483647 です。 + bindecは、2進数をintegerに変換 + します。変換可能な最も大きな数字は 1 が 31 ビット並んだ 2進数で + あり、10進数の2147483647です。 decbin 関数も参照下さい。 @@ -503,7 +504,7 @@ int getrandmax - void + void @@ -563,7 +564,7 @@ lcg_value は、(0, 1)の範囲の疑似乱数を返しま す。この関数は、周期が2^31 - 85および2^31 - 249の2つの CG を組み - 合わせます。この颦հの周期はこれら2つの素数の積と等価です。 + 合わせます。この関数の周期はこれら2つの素数の積と等価です。 @@ -811,9 +812,15 @@ string number_format float number - int decimals - string dec_point - string thousands_sep + int + decimals + + string + dec_point + + string + thousands_sep + @@ -840,24 +847,53 @@ えられた文字列を使い、小数部の前のドット(".")の代わりに dec_pointで与えられた文字列を使います。 + + + thousands_sepの最初の文字のみが使用され + ます。例えば、数値1000について + foothousands_sep + に使用した場合、number_format は、 + 1f000を返します。 + + - 例えば、フランス語表記では通常小数点以下は2桁とし、カンマ(',')を - 小数部の区切り文字、スペースを1000の位毎の区切り文字として使用し - ます。これは、次のように行います。 - + + <function>number_format</function> の例 + + 例えば、フランス語表記では通常小数点以下は2桁とし、カンマ + (',')を小数部の区切り文字、スペース(' ')を1000の位毎の区切り + 文字として使用します。これは、次のように行います。 + <?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 + ?> - + + + + sprintf, + printf , sscanfも + 参照下さい。 + + @@ -895,12 +931,22 @@ double pi - void + void 円周率の近似値を返します。 + + + + +echo pi(); +// 3.1415926535898 を出力します。 + + + + @@ -920,9 +966,36 @@ baseexp 乗を返 - します。これが計算できない場合、expは、 - NANを返します。 + します。可能な場合、この関数は、integer型の値を + 返します。 + + 累乗が計算できない場合、警告が発生し、 + pow は &false;を返します。 + + + <function>pow</function>の例 + + +]]> + + + + + PHP 4.0.6 より前のバージョンでは、powは + 常にfloatを返します。この場合、警告の問題は + ありません。 + + expも参照下さい。 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 @@ pdf_arc - 円弧を描く + (反時計回りに)円弧を描く 説明 void pdf_arc - int pdf object - double x - double y - double r - double alpha - double beta + resource pdf object + float x + float y + float r + float alpha + float beta 反時計周りにalpha度からbeta度まで円弧を描画します。 + + pdf_arcnも参照下さい。 + pdf_arcn - 円弧を描く + (時計回りに)円弧を描く 説明 void pdf_arc - int pdf object - double x - double y - double r - double alpha - double beta + resource pdf object + float x + float y + float r + float alpha + float beta alpha度からbeta度まで円弧を時計周りに描きます。 + + pdf_arcも参照下さい。 + @@ -1612,7 +1618,7 @@ 説明 - int pdf_open + int pdf_open_ccitt int pdf object string filename int width 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 @@ mixed printer_open - [string devicename] + string + devicename + - この関数は、プリンタdevicenameへの接続を試み、成功時にハンドル、失敗時に&false;を返します。 + この関数は、プリンタdevicenameへの接続を + 試み、成功時にハンドル、失敗時に&false;を返します。 - パラメータが指定されない場合、この関数はデフォルトのプリンタへの接続をオープンします。(php.iniにprinter.default_printerとして指定されていない場合は、PHPはデフォルトのプリンタの検出を試みます) + パラメータが指定されない場合、この関数はデフォルトのプリンタへ + の接続をオープンします。(php.iniに + printer.default_printerとして指定されていな + い場合は、PHPはデフォルトのプリンタの検出を試みます) - printer_open は、デバイスコンテキストも開始します。 + printer_open は、デバイスコンテキストも + 開始します。 <function>printer_open</function> の例 @@ -142,8 +149,12 @@ array printer_list int enumtype - [string name - [int level]] + string + name + + int + level + @@ -563,7 +574,9 @@ bool printer_start_doc resource handle - [string document] + string + document + @@ -604,9 +617,9 @@ - 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 printer_start_doc. + Closes a new document in the printer spooler. The document + is now ready for printing. For an example see + printer_start_doc. handle must be a valid handle to a printer. @@ -1032,9 +1045,20 @@ - italic can be &true; or &false;, and sets whether the font should be italic. - underline can be &true; or &false;, and sets whether the font should be underlined. - strikeout can be &true; or &false;, and sets whether the font should be striked out. + + + italic can be &true; or &false;, + and sets whether the font should be italic. + + + underline can be &true; or &false;, + and sets whether the font should be underlined. + + + strikeout can be &true; or &false;, + and sets whether the font should be striked out. + + orientation specifies a rotation. For an example see printer_select_font. @@ -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 @@ - AddCSlashes + addcslashes C言語と同様にスラッシュで文字列をクォートする @@ -62,7 +62,7 @@ - AddSlashes + addslashes 文字列をスラッシュでクォートする @@ -113,37 +113,19 @@ chop - 最後尾のホワイトスペースを取り除く + rtrimへのエイリアス 説明 - - - string chop - string str - - - パラメータである文字列から改行を含む最後尾のホワイトスペースを取り除いた - ものを返します。 - - <function>chop</function>の例 - -$trimmed = chop ($line); - - + この関数は、rtrimへのエイリアスです。 - chop は、文字列から最後の文字を削除する - Perl の chop() 関数とは異なっています。 + chop は、文字列の末尾の文字を削除するPerlの + chop()関数とは異なっています。 - - trim, ltrim, - rtrim, chop - も参照下さい。 - @@ -515,7 +497,7 @@ // しかし、次の例は動作します。 ($some_var) ? print('true'): print('false'); // print は関数 -echo ($some_var) ? 'true': 'false'; // 命令を変更 +echo $some_var ? 'true': 'false'; // 命令を変更 ?> @@ -1287,6 +1269,7 @@ + ltrim @@ -1300,16 +1283,89 @@ string ltrim string str + string + charlist + この関数は文字列の最初から空白文字を取り除き、 - 取り除かれた文字列を返します。現在のところ削除される空白文字は、 - "\n", "\r", "\t", "\v", "\0"および通常のスペースです。 + 取り除かれた文字列を返します。2番目のパラメータを指定しない場合、 + ltrimは以下の文字を削除します。 + + + + + " " (ASCII 32 + (0x20)), 通常の空白。 + + + + + "\t" (ASCII 9 + (0x09)), タブ。 + + + + + "\n" (ASCII 13 + (0x0D)), 改行。 + + + + + "\r" (ASCII 10 + (0x0A)), リターン。 + + + + + "\0" (ASCII 0 + (0x00)), NULバイト + + + + + "\x0B" (ASCII 11 + (0x0B)), a . + + + - chop, rtrim, - trim も参照下さい。 + charlistパラメータにより、削除する + 文字を指定することも可能です。削除したい全ての文字をリストに + して下さい。..を文字の範囲を指定する際に + 使用可能です。 + + + <function>ltrim</function>の使用例 + + + +]]> + + + + + + 2番目のパラメータは、PHP 4.0.7で追加されました。 + + + + trim および rtrimも + 参照下さい。 @@ -1585,10 +1641,11 @@ + rtrim - 終端の空白文字を削除する + 文字列の最後から空白文字を削除する 説明 @@ -1596,21 +1653,89 @@ string rtrim string str + string + charlist + - 引数の文字列から改行を含む終端の空白文字を削除して返します。 - この関数は、chopのエイリアスです。 - - <function>rtrim</function> の例 + この関数は文字列の最後から空白文字を取り除き、 + 取り除かれた文字列を返します。2番目のパラメータを指定しない場合、 + rtrimは以下の文字を削除します。 + + + + + " " (ASCII 32 + (0x20)), 通常の空白。 + + + + + "\t" (ASCII 9 + (0x09)), タブ。 + + + + + "\n" (ASCII 13 + (0x0D)), 改行。 + + + + + "\r" (ASCII 10 + (0x0A)), リターン。 + + + + + "\0" (ASCII 0 + (0x00)), NULバイト + + + + + "\x0B" (ASCII 11 + (0x0B)), a . + + + + + + charlistパラメータにより、削除する + 文字を指定することも可能です。削除したい全ての文字をリストに + して下さい。..を文字の範囲を指定する際に + 使用可能です。 + + + <function>rtrim</function>の使用例 + -$trimmed = rtrim ($line); + +]]> - - + + + + + 2番目のパラメータは、PHP 4.0.7で追加されました。 + + - trim, ltrim, - rtrimも参照下さい。 + trim および ltrimも + 参照下さい。 @@ -2950,14 +3075,13 @@ - string を、アルファベット部分を + string をアルファベット部分を すべて小文字にして返します。 「アルファベット部分」は現在のロケールにより決定されます。 このため、たとえばデフォルトの "C" ロケールである場合は、 - ウムラウトA (訳注:日本語文字セットでは表示できない文字のため省略) - のような文字は変換されません。 + ウムラウトA (Ä) のような文字は変換されません。 <function>strtolower</function>の例 @@ -3339,6 +3463,7 @@ + trim @@ -3352,17 +3477,89 @@ string trim string str + string + charlist + - この関数は、文字列の先頭および末尾にあるホワイトスペースを - 取り除き、その結果の文字列を返します。 - 現在のところ取り除かれるホワイトスペース文字は - "\n"、"\r"、"\t"、"\v"、"\0"および通常のスペース(空白)です。 + この関数は文字列の最初および最後から空白文字を取り除き、 + 取り除かれた文字列を返します。2番目のパラメータを指定しない場合、 + trimは以下の文字を削除します。 + + + + + " " (ASCII 32 + (0x20)), 通常の空白。 + + + + + "\t" (ASCII 9 + (0x09)), タブ。 + + + + + "\n" (ASCII 13 + (0x0D)), 改行。 + + + + + "\r" (ASCII 10 + (0x0A)), リターン。 + + + + + "\0" (ASCII 0 + (0x00)), NULバイト + + + + + "\x0B" (ASCII 11 + (0x0B)), a . + + + + + + charlistパラメータにより、削除する + 文字を指定することも可能です。削除したい全ての文字をリストに + して下さい。..を文字の範囲を指定する際に + 使用可能です。 + + <function>trim</function>の使用例 + + + +]]> + + + + + + 2番目のパラメータは、PHP 4.0.7で追加されました。 + + - chop, rtrim, - ltrimも参照下さい。 + ltrim および rtrimも + 参照下さい。 @@ -3389,7 +3586,7 @@ 「アルファベット」かどうかというのは現在のロケールにより決定 されます。たとえば、デフォルトの "C" ロケールでは、ウムラウトa - (訳注:日本語文字セットの非表示文字のため省略)は変換されません。 + (ä)は変換されません。 <function>ucfirst</function>の例 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 @@ resource xh + &warn.experimental.func; @@ -100,6 +101,7 @@ + &warn.experimental.func; この関数は、新規のXSLTプロセッサへのハンドルを返します。このハン ドルは、この後に使用する全てのXSLT関数をコールする際に必要です。 @@ -117,13 +119,10 @@ int xslt_errno - int - - xh - - + resource xh + &warn.experimental.func; 指定したXSLTプロセッサについてカレントのエラー番号を返します。ハ ンドルが指定されていない場合、どこかで発生した直近のエラー番号が @@ -142,13 +141,10 @@ mixed xslt_error - int - - xh - - + resource xh + &warn.experimental.func; 指定したXSLTプロセッサについてカレントのエラー文字列を返します。 ハンドラが指定されない場合、どこかで発生した直近のエラー文字列が @@ -167,14 +163,11 @@ string xslt_fetch_result - int xh - - string - result_name - - + resource xh + string result_name + &warn.experimental.func; ハンドルにより指定したXSLTプロセッサから結果バッファを取得します。 result_name が指定されない場合、 @@ -193,11 +186,10 @@ void xslt_free - - resource xh - + resource xh + &warn.experimental.func; ハンドルで指定したXSLTプロセッサを開放します。 @@ -216,19 +208,12 @@ bool xslt_openlog - - resource xh - - - string logfile - - - - int loglevel - - + resource xh + string logfile + int loglevel + &warn.experimental.func; XSLT プロセッサのエラーメッセージを全て記録するログファイルを設定 します。 @@ -248,11 +233,10 @@ void xslt_output_begintransform - - string xslt_filename - + string xslt_filename + &warn.experimental.func; この関数は、データ出力の変換を開始します。 xslt_output_begintransform をコールした場所 @@ -307,6 +291,7 @@ + &warn.experimental.func; xslt_output_endtransform は、 xslt_output_begintransform 関数で開始した出力の変換を @@ -328,13 +313,12 @@ bool xslt_process - - string xsl_data - string xml_data - string result - + string xsl_data + string xml_data + string result + &warn.experimental.func; xslt_process は、XSLT スタイルシートを有する 文字列を最初の引数、変換したいXMLデータを有する文字列を2番目の引 @@ -361,7 +345,7 @@ <table border="1" cellpadding="2" cellspacing="1"> <tr> <td width="20%"> - &#160; + &#160; </td> <td width="80%"> <h2><xsl:value-of select="title"/></h2> @@ -417,26 +401,15 @@ bool xslt_run - resource xh - string xslt_file - string xml_data_file - - - string result - - - - - array xslt_params - - - - - array xslt_args - - + resource xh + string xslt_file + string xml_data_file + string result + array xslt_params + array xslt_args + &warn.experimental.func; xslt_file スタイルシートを適用することにより xml_data_file を処理 する。スタイルシートは xslt_params にアクセスし、プロセッサは @@ -456,14 +429,14 @@ bool xslt_set_sax_handler - - resource xh - array handlers - + resource xh + array handlers + &warn.experimental.func; - xh で指定したリソースハンドルに SAX ハンドラを設定します。 + xhで指定したリソースハンドルにSAX ハンドラ + を設定します。 @@ -480,16 +453,15 @@ bool xslt_transform - - string xsl - string xml - string result - string params - string args - string resultBuffer - + string xsl + string xml + string result + string params + string args + string resultBuffer + &warn.experimental.func; xslt_transform は、リソース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 @@ インストール - YAZをコンパイルし、インストールして下さい。PHPをオプション-- - with-yazを付けて他の任意のモジュールとコンパイルして下さい。この - 手順の概要を以下に示します。 + YAZをコンパイルし、インストールして下さい。PHPをオプション + --with-yazを付けて他の任意のモジュールと + コンパイルして下さい。この手順の概要を以下に示します。 @@ -181,8 +181,8 @@ int yaz_connect string zurl - string - authentication + mixed + options @@ -195,6 +195,59 @@ yaz_waitがコールされた際に接続を実行する準備 を行うだけです。 + + 2番目の引数、optionsに文字列が指定された場合、 + Z39.50 V2認証文字列(OpenAuth)として処理されます。 + + + options に配列が指定された場合、その配列の内 + 容はオプションとして処理されます。配列オプションは、PHP 4.0.7以降 + でのみサポートされることに注意して下さい。 + + + <function>yaz_connect</function> オプション + user + 認証用のユーザ名 + + + group + 認証用のグループ + + + password + 認証用のパスワード + + + cookie + セッションクッキー (YAZ proxy). + + + proxy + 接続用プロキシ (YAZ proxy). + + + persistent + + 論理値。&true; の場合、接続は持続的となります。&false; の + 場合、接続は持続的ではありません。デフォルトで、接続は + 持続的です。 + + + + piggyback + + 論理値。&true; の場合、検索時のpiggybackが有効になります。 + &false; の場合、piggybackが無効になります。デフォルトでは、 + piggyback は有効です。piggybackを有効にするとより効率的となり、 + 通常、レコードを最初に取得する際のネットワーク往復時間を節約 + することが可能です。しかし、少数の Z39.50ターゲットは + piggybackをサポートしていないか、エレメント集合名を無視します。 + この場合、piggybackを無効とする必要があります。 + + + + + @@ -446,37 +499,36 @@ - - - 以下は、有効なクエリ構造を説明するものです。 - + + + クエリの例 + + クエリ computer - - "computer" がある文書にマッチします。属性は指定されてません。 - - - + は、"computer"を含む文書にマッチします。属性は指定されていません。 + + + クエリ "donald knuth" - - "donald knuth" がある文書にマッチします。 - - - -  <email protected> 1=4 art - - 属性型は1 (Bib-1 使用)で、属性値は 4(タイトル)です。これにより、 - "art"がタイトルにある文書にマッチします。 - - - + は、"donald knuth" がある文書にマッチします。 + + + クエリ +  <email protected> 1=4 artの場合、 + 属性型は1 (Bib-1 use)、属性の値は4 (Title)となります。このため、 + titleにartが現れる文書にマッチします。 + + + その他のより複雑なクエリの例:  <email protected> gils  <email protected>  <email protected> 1=4 art  <email protected> 1=1003 "donald knuth" - - このクエリは全体にGILS属性セットを使用します。このクエリはtitleに - "art"があり、authorに"donald knuth"がある文書にマッチします。 - + このクエリは、GILS属性集合を使用しています。クエリはtitleに + artが現れ、authorにdonald knuth + が現れる文書にマッチします。 + + - + yaz_present @@ -850,7 +902,9 @@ int yaz_wait - + + array options + @@ -862,6 +916,21 @@ トが全てのリクエストを完了したか、(エラーの場合には)中断された場 合に処理を戻します。 + + 配列 options が指定された場合、 + yaz_waitの動作を変更するオプションとなります。 + + + timeout + + + 時間のタイムアウトを設定します。ターゲットが時間内に応答しなかっ + た場合、動作していないとみなされ、yaz_wait + は帰ります。タイムアウトのデフォルト値は15sです。 + + + +