Index: phpdoc/ja/Translators diff -u phpdoc/ja/Translators:1.14 phpdoc/ja/Translators:1.15 --- phpdoc/ja/Translators:1.14 Mon Nov 13 13:41:00 2000 +++ phpdoc/ja/Translators Sun Nov 26 04:47:14 2000 @@ -60,6 +60,7 @@ functions/image.xml Chihiro Higuchi functions/imap.xml Michihide Hotta functions/info.xml Michihide Hotta +functions/ingres_ii.xml Rui Hirokawa functions/mail.xml Rui Hirokawa functions/math.xml Machino Satoshi functions/mcal.xml Rui Hirokawa Index: phpdoc/ja/functions/errorfunc.xml diff -u phpdoc/ja/functions/errorfunc.xml:1.3 phpdoc/ja/functions/errorfunc.xml:1.4 --- phpdoc/ja/functions/errorfunc.xml:1.3 Sun Nov 19 15:00:22 2000 +++ phpdoc/ja/functions/errorfunc.xml Sun Nov 26 04:47:14 2000 @@ -445,7 +445,7 @@ ユーザハンドラ関数は、要すれば die をコール する責任があることにも注意を要します。エラーハンドラ関数がリター - ンした場合、スクプトの実行は、エラーを発生した命令の次の命令に + ンした場合、スクプトの実行は、エラーを発生した命令の次の命令に 継続されます。 @@ -478,11 +478,15 @@ ユーザエラーを発生するために使用され、組込のエラーハンドラまたは 新しいエラーハンドラ(set_error_handler)とし - て設定済のユーザ定義関数と組み合わせて使用されます。この関数は、 - 実行時の例外に特定の応答を生成する必要がある場合に有用です。 - 以下に例を示します。 + て設定済のユーザ定義関数と組み合わせて使用されます。エラー型には + E_USER 関連の定数のみが使用可能で、デフォルトは + E_USER_NOTICEとなっています。 + + + この関数は、実行時の例外に特定の応答を生成する必要がある場合に有 + 用です。以下に例を示します。 - + if (assert($divisor == 0)) trigger_error("Cannot divide by zero", E_USER_ERROR); Index: phpdoc/ja/functions/funchand.xml diff -u phpdoc/ja/functions/funchand.xml:1.1 phpdoc/ja/functions/funchand.xml:1.2 --- phpdoc/ja/functions/funchand.xml:1.1 Sat Sep 9 22:15:50 2000 +++ phpdoc/ja/functions/funchand.xml Sun Nov 26 04:47:20 2000 @@ -359,10 +359,23 @@ string function_name - - function_name について定義された関数のリストを - 確認します。指定した関数名がある場合にtrue、他の場合にfalseを返します。 - + + function_name について定義された関数のリス + トを確認します。指定した関数名がある場合にtrue、他の場合にfalseを + 返します。 + + +if (function_exists('imap_open')) { + echo "IMAP 関数が利用可能です。<br>\n"; +} else { + echo "IMAP 関数は利用できません。<br>\n"; +} + + + + + method_exists も参照下さい。 + Index: phpdoc/ja/functions/ingres_ii.xml diff -u phpdoc/ja/functions/ingres_ii.xml:1.1 phpdoc/ja/functions/ingres_ii.xml:1.2 --- phpdoc/ja/functions/ingres_ii.xml:1.1 Mon Nov 20 13:08:39 2000 +++ phpdoc/ja/functions/ingres_ii.xml Sun Nov 26 04:47:20 2000 @@ -1,37 +1,39 @@ - Ingres II functions + Ingres II 関数 Ingres II - These functions allow you to access Ingres II database servers. + これらの関数により、Ingres II データベースサーバにアクセスできるよ + うになります。 - In order to have these functions available, you must compile php - with Ingres support by using the - option. - You need the Open API library and header files included with - Ingres II. If the II_SYSTEM environment variable isn't correctly - set you may have to use - - to specify your Ingres installation directory. + これらの関数を利用可能とするには、オプション + を付けて Ingres サ + ポートを有効にしてPHPをコンパイルする必要があります。コンパイルに + は、Ingres II に含まれる Open API ライブラリとヘッダが必要です。 + 環境変数 II_SYSTEM が正確に設定されていない場合、Ingres がインストー + ルされたディレクトリを指定するために + を使用する必要 + があるかもしれません。 - When using this extension with Apache, if Apache does not start - and complains with "PHP Fatal error: Unable to start - ingres_ii module in Unknown on line 0" - then make sure the environement variable II_SYSTEM is correctly - set. Adding "export II_SYSTEM="/home/ingres/II" in the script - that starts Apache, just before launching httpd, should be fine. + この拡張モジュールを Apache で使用する際に Apache が起動せず、 + "PHP Fatal error: Unable to start + ingres_ii module in Unknown on line 0" というエラーが発生する場合、 + 環境変数 II_SYSTEM が正確に設定されているかどうかを確認して下さい。 + "export II_SYSTEM="/home/ingres/II" を Apache を開始するスクリプト + に追加して下さい。この後、httpd を起動すれば、うまくいくはずです。 - If you already used PHP extensions to access other database servers, - note that Ingres doesn't allow concurrent queries and/or transaction - over one connection, thus you won't find any result or transaction - handle in this extension. The result of a query must be treated - before sending another query, and a transaction must be commited or - rolled back before opening another transaction (which is automaticaly - done when sending the first query). + 他のデータベースサーバにアクセスするために既にPHP 拡張モジュール + を使用している場合、Ingres は同一のコネクションについて複数のクエ + リやトランザクションの並列実行ができない、つまり、この拡張モジュー + ルにおいて結果およびトランザクションのハンドルを得ることができない + ことに注意する必要があります。クエリの結果は、別のクエリを送信す + る前に処理する必要があり、トランザクションは別のトランザクション + をオープンする前にコミットまたはロールバックする必要があります。 + (これは、最初のクエリを送信する際に自動的に行われます) @@ -39,10 +41,10 @@ ingres_connect - Open a connection to an Ingres II database. + Ingres II データベースへの接続をオープンする - Description + 説明 resource ingres_connect @@ -58,55 +60,59 @@ - Returns a Ingres II link resource on success, or false on failure. + 成功時に Ingres II リンクリソース、失敗した際に false を返します。 - ingres_connect opens a connection with the - Ingres database designated by database, which - follows the syntax [node_id::]dbname[/svr_class]. + ingres_connect は、 + database とこの後に続く + [node_id::]dbname[/svr_class] 構文により指 + 定された Ingres データベースへの接続をオープンします。 - If some parameters are missing, ingres_connect - uses the values in php.ini for - ingres.default_database, - ingres.default_user and - ingres.default_password. + いくつかのパラメータが欠けている場合、 + ingres_connect は、 + ingres.default_database、 + ingres.default_user、 + ingres.default_password に関して + php.ini の値を使用します。 - The connection is closed when the script ends or when - ingres_close is called on this link. + 接続は、スクリプトの実行終了時または、このリンクについて + ingres_close がコールされた場合にクローズさ + れます。 - All the other ingres functions use the last opened link as a - default, so you need to store the returned value only if you use - more than one link at a time. + 他の全ての Ingres 関数は、デフォルトで直近にオープンされたリンク + を使用します。このため、複数のリンクを同時に使用したい場合には、 + 返された値を保存しておく必要があります。 - <function>ingres_connect</function> example - + <function>ingres_connect</function> の例 + <?php $link = ingres_connect ("mydb", "user", "pass") - or die ("Could not connect"); - print ("Connected successfully"); + or die ("接続できません"); + print ("接続に成功しました"); ingres_close ($link); ?> - <function>ingres_connect</function> example - using default link - + + デフォルトリンクを使用する<function>ingres_connect</function>の例 + + <?php ingres_connect ("mydb", "user", "pass") - or die ("Could not connect"); - print ("Connected successfully"); + or die ("接続できません"); + print ("接続に成功しました"); ingres_close (); ?> - See also - ingres_pconnect, and - ingres_close. + + ingres_pconnect および + ingres_closeも参照下さい。 @@ -115,11 +121,11 @@ ingres_pconnect - Open a persistent connection to an Ingres II database. + Ingres II データベースへの持続的接続をオープンする - Description + 説明 resource ingres_pconnect @@ -135,26 +141,26 @@ - Returns a Ingres II link resource on success, or false on failure. + 成功した際に Ingres II リンクリソース、失敗した際に false を返し + ます。 - See ingres_connect for parameters details and - examples. There are only 2 differences between - ingres_pconnect and - ingres_connect : - First, when connecting, the function will first try to find a - (persistent) link that's already opened with the same parameters. - If one is found, an identifier for it will be returned instead of - opening a new connection. Second, the connection to the Ingres - server will not be closed when the execution of the script ends. - Instead, the link will remain open for future use - (ingres_close will not close links established - by ingres_pconnect). This type of link is - therefore called 'persistent'. - - See also - ingres_connect, and - ingres_close. + パラメータの詳細と例については、 + ingres_connect を参照下さい。 + ingres_pconnect と + ingres_connect の違いは次の2つだけです。 + まず、接続時にこの関数は、まず同じパラメータ既にオープンされて + いる(持続的な)リンクを探すことです。第2に、Ingres サーバへの接続 + はスクリプトの実行終了時にもクローズされないところです。代わりに、 + リンクは、後で使用するためにオープンされたままとなります。 + (ingres_close は、 + ingres_pconnectにより確立されたリンクをクロー + ズしません) このため、この型のリンクは「持続的(persistent)」であ + ると呼ばれます。 + + + ingres_connect および + ingres_close も参照下さい。 @@ -162,10 +168,10 @@ ingres_close - Close an Ingres II database connection + Ingres II データベース接続を閉じる - Description + 説明 boolingres_close @@ -175,22 +181,22 @@ - Returns true on success, or false on failure. + 成功時にtrue、失敗時にfalseを返します。 - ingres_close closes the connection to - the Ingres server that's associated with the specified link. - If the link parameter isn't - specified, the last opened link is used. + ingres_close は、指定したリンクが指す Ingres + サーバへの接続をクローズします。パラメータ + linkが指定されない場合、直近にオープンされ + たリンクが使用されます。 - ingres_close isn't usually necessary, as it - won't close persistent connections and all non-persistent connections - are automatically closed at the end of the script. + 持続的接続をクローズすることはできず、持続的でない接続はスクリプ + トの終了時に自動的にクローズされるため、 + ingres_close は通常は不要です。 - See also - ingres_connect, and - ingres_pconnect. + + ingres_connect および + ingres_pconnect も参照下さい。 @@ -198,10 +204,10 @@ ingres_query - Send a SQL query to Ingres II + Ingres II にSQLクエリを送信する - Description + 説明 boolingres_query @@ -214,60 +220,64 @@ - Returns true on success, or false on failure. + 成功時にtrue、失敗時にfalseを返します。 - ingres_query sends the given - query to the Ingres server. This query - must be a valid SQL query (see the Ingres SQL reference guide) + ingres_query は、指定した + query を Ingres サーバに送信します。このク + エリは、有効なSQLクエリである必要があります。(Ingres SQL リファレ + ンスガイドを参照下さい) + + + クエリは、現在オープンされているトランザクションの一部となります。 + オープンされているトランザクションがない場合、 + ingres_query は新規のトランザクションをオー + プンします。トランザクションをクローズするには、データベースへの + 変更をコミットする場合に ingres_commit を、 + これらの変更をキャンセルする場合に + ingres_rollback のどちらかを使用することが可 + 能です。スクリプト終了時に、全てのオープンされたトランザクション + は(ingres_rollbackをコールすることにより) + ロールバックされます。新規トランザクションをオープンする前に + ingres_autocommit を使用することも可能です。 + この場合、各SQLクエリは直ちにコミットされます。 - The query becomes part of the currently open transaction. - If there is no open transaction, ingres_query - opens a new transaction. To close the transaction, you can either - call ingres_commit to commit the changes made - to the database or ingres_rollback to cancel these - changes. When the script ends, any open transaction is rolled back - (by calling ingres_rollback). You can also - use ingres_autocommit before opening a new - transaction to have every SQL query immediatly commited. - - - Some types of SQL queries can't be sent with this function : + 次の型のSQLクエリは、この関数で送信できません。 - close (see ingres_close). + close (ingres_closeを参照) - commit (see ingres_commit). + commit (ingres_commitを参照) - connect (see ingres_connect). + connect (ingres_connectを参照) - disconnect (see ingres_close). + disconnect (ingres_closeを参照) get dbevent prepare to commit - rollback (see ingres_rollback). + rollback (ingres_rollbackを参照) savepoint - set autocommit (see ingres_autocommit). + set autocommit (ingres_autocommitを参照) - all cursor related queries are unsupported + カーソルに関係するクエリはサポートされていません - <function>ingres_query</function> example + <function>ingres_query</function> の例 <?php ingres_connect ($database, $user, $password); @@ -282,13 +292,12 @@ - See also ingres_fetch_array, ingres_fetch_object, ingres_fetch_row, ingres_commit, - ingres_rollback and - ingres_autocommit. + ingres_rollback, + ingres_autocommit も参照下さい。 @@ -297,11 +306,11 @@ ingres_num_rows - Get the number of rows affected or returned by the last query + 直近のクエリで作用されたレコードの数を取得し、返す - Description + 説明 intingres_num_rows @@ -349,11 +358,11 @@ ingres_num_fields - Get the number of fields returned by the last query + 直近のクエリにより返されたフィールドの数を得る - Description + 説明 intingres_num_fields @@ -380,10 +389,10 @@ ingres_field_name - Get the name of a field in a query result. + クエリ結果においてフィールド名を得る - Description + 説明 stringingres_field_name @@ -417,10 +426,10 @@ ingres_field_type - Get the type of a field in a query result. + クエリ結果においてフィールドの型を得る - Description + 説明 stringingres_field_type @@ -461,10 +470,10 @@ ingres_field_nullable - Test if a field is nullable. + フィールドにNULL値を設定可能かどうか調べる - Description + 説明 boolingres_field_nullable @@ -498,10 +507,10 @@ ingres_field_length - Get the length of a field. + フィールド長を得る - Description + 説明 intingres_field_length @@ -536,10 +545,10 @@ ingres_field_precision - Get the precision of a field. + フィールドの精度を得る - Description + 説明 intingres_field_precision @@ -575,10 +584,10 @@ ingres_field_scale - Get the scale of a field. + フィールドのスケールを得る - Description + 説明 intingres_field_scale @@ -613,10 +622,10 @@ ingres_fetch_array - Fetch a row of result into an array. + 1行分の結果を配列に取得する - Description + 説明 arrayingres_fetch_array @@ -664,7 +673,7 @@ - <function>ingres_fetch_array</function> example + <function>ingres_fetch_array</function> の例 <?php ingres_connect ($database, $user, $password); @@ -694,10 +703,10 @@ ingres_fetch_row - Fetch a row of result into an enumerated array. + 1行分の結果を数値添字配列として取得する - Description + 説明 arrayingres_fetch_row @@ -745,10 +754,10 @@ ingres_fetch_object - Fetch a row of result into an object. + 1行分の結果をオブジェクトとして取得する - Description + 説明 objectingres_fetch_object @@ -811,10 +820,10 @@ ingres_rollback - Roll back a transaction. + トランザクションをロールバックする - Description + 説明 boolingres_rollback @@ -844,10 +853,10 @@ ingres_commit - Commit a transaction. + トランザクションをコミットする - Description + 説明 boolingres_commit @@ -881,10 +890,10 @@ ingres_autocommit - Switch autocommit on or off. + autocommit を オンまたはオフに切替える - Description + 説明 boolingres_autocommit Index: phpdoc/ja/functions/var.xml diff -u phpdoc/ja/functions/var.xml:1.20 phpdoc/ja/functions/var.xml:1.21 --- phpdoc/ja/functions/var.xml:1.20 Sun Nov 5 07:01:27 2000 +++ phpdoc/ja/functions/var.xml Sun Nov 26 04:47:20 2000 @@ -182,7 +182,7 @@ 説明 - int is_array + bool is_array mixed var @@ -214,12 +214,8 @@ 説明 - int - is_bool - - mixed - var - + bool is_bool + mixed var @@ -245,7 +241,7 @@ 説明 - int is_double + bool is_double mixed var @@ -276,7 +272,7 @@ 説明 - int is_float + bool is_float mixed var @@ -306,7 +302,7 @@ 説明 - int is_int + bool is_int mixed var @@ -336,7 +332,7 @@ 説明 - int is_integer + bool is_integer mixed var @@ -366,7 +362,7 @@ 説明 - int is_long + bool is_long mixed var @@ -397,12 +393,11 @@ 説明 - int is_numeric + bool is_numeric mixed var - varが数値または数値文字列である場合に true、その他の場合にfalseを返します。 @@ -429,7 +424,7 @@ 説明 - int is_object + bool is_object mixed var @@ -460,7 +455,7 @@ 説明 - int is_real + bool is_real mixed var @@ -492,22 +487,18 @@ 説明 - int - is_resource - - mixed - var - + bool is_resource + mixed var - is_resourceはパラメータvar - で指定した変数がリソースの場合にtrueを返し、その他の場合にfalseを - 返します。 + is_resourceはパラメータ + varで指定した変数がリソースの場合にtrueを + 返し、その他の場合にfalseを返します。 リソースとはファイルやデータベース結果ハンドル等を意味し、 - PHP内部関数により確保や開放が行われます。これらのリソースに関しf + PHP内部関数により確保や開放が行われます。これらのリソースに関して 使用終了後でかつユーザのコードにより開放が行われていない場合に、 何らかのクリーンアップが必要となる可能性があります。 @@ -523,7 +514,7 @@ 説明 - int is_string + bool is_string mixed var @@ -648,7 +639,7 @@ type にセットします。 - type の値は下のいずれかです。 + type の値は令؋のいずれかです。 "integer" Index: phpdoc/ja/functions/xslt.xml diff -u phpdoc/ja/functions/xslt.xml:1.2 phpdoc/ja/functions/xslt.xml:1.3 --- phpdoc/ja/functions/xslt.xml:1.2 Mon Nov 13 13:41:00 2000 +++ phpdoc/ja/functions/xslt.xml Sun Nov 26 04:47:20 2000 @@ -28,9 +28,8 @@ UNIXでは、オプション を指 - 定して configure を実行します。ライブラリ + role="configure">--with-sablot を指定して + configure を実行します。ライブラリ Sablotron をコンパイラが見付けられる 場所にインストールする必要があります。 @@ -227,20 +226,53 @@ xslt_output_begintransform - unknown + 出力の XSLT 変換を開始する 説明 - unknown xslt_output_begintransform - - unknown - + void + xslt_output_begintransform + + + string xslt_filename + - この関数には、プロトタイプがありません。 + この関数は、データ出力の変換を開始します。 + xslt_output_begintransform をコールした場所 + から、xslt_output_endtransform をコールした + 場所まで、最初の引数で指定したXSLTスタイルシートにより全ての出力 + は変換されます。 + + + + + XSLTスタイルシートによる出力の変換、xml 生成用にDOM-XML関数を使 + 用する + + +<?php + +$xsl_file = "article.xsl"; +xslt_output_begintransform($xsl_file); + +$doc = new_xmldoc('1.0'); +$article = $doc->new_root('article'); + +$article->new_child('title', 'The History of South Tyrol'); +$article->new_child('author', 'Sterling Hughes'); +$article->new_child('body', 'Back after WWI, Italy gained South Tyrol from + Austria. Since that point nothing interesting has + happened'); + +echo $doc->dumpmem(); + +xslt_output_endtransform(); + + @@ -248,41 +280,122 @@ xslt_output_endtransform - unknown + + xslt_output_begintransformで開始した出力の変換を終了する + 説明 - unknown xslt_output_endtransform - - unknown - + void + xslt_output_endtransform + + - この関数には、プロトタイプがありません。 + xslt_output_endtransform は、 + xslt_output_begintransform 関数で開始した出力の変換を + 終了します。出力の変換の結果を見るためには、この関数をコールする + 必要があります。 - xslt_output_process - unknown + xslt_process + XSLデータを有する文字列によりXMLデータを変換する 説明 - unknown xslt_process - - unknown - - - - - この関数には、プロトタイプがありません。 + bool + xslt_process + + + string xsl_data + string xml_data + string result + + + + + xslt_process は、XSLT スタイルシートを有する + 文字列を最初の引数、変換したいXMLデータを有する文字列を2番目の引 + 数、変換結果を有する文字列を3番目の引数とします。 + xslt_process は、成功時に true、失敗時に + false を返します。エラーが発生した場合にエラー番号とエラー文字列 + を得るには、関数 xslt_errno および + xslt_error を使用して下さい。 + + + + + 3つの文字列を変換するために <function>xslt_process</function> + を使用する + + +<?php + +$xslData = ' +<xsl:stylesheet + version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> + +<xsl:template match="article"> + <table border="1" cellpadding="2" cellspacing="1"> + <tr> + <td width="20%"> +   + </title> + <td width="80%"> + <h2><xsl:value-of select="title"></h2> + <h3><xsl:value-of select="author"></h3> + <br> + + <xsl:value-of select="body"> + </td> + </tr> + </table> +</xsl:template> + +</xsl:stylesheet>'; + +$xmlData = ' +<?xml version="1.0"?> +<article> + <title>Learning German</title> + <author>Sterling Hughes</author> + <body> + Essential phrases: + <br> + <br> + Komme sie mir sagen, woe die toilette es?<br> + Eine grande beer bitte!<br> + Noch einem bitte.<br> + </body> +</article>'; + +if (xslt_process($xslData, $xmlData, $result)) +{ + echo "Here is the brilliant in-depth article on learning" + echo " German: "; + echo "<br>\n<br>"; + echo $result; +} +else +{ + echo "There was an error that occurred in the XSL transformation...\n"; + echo "\tError number: " . xslt_errno() . "\n"; + echo "\tError string: " . xslt_error() . "\n"; + exit; +} +?> + + @@ -341,20 +454,28 @@ xslt_transform - unknown + XSLT 変換を実行する 説明 - unknown xslt_transform - - unknown + bool + xslt_transform + + + string xsl + string xml + string result + string params + string args + string resultBuffer - この関数には、プロトタイプがありません。 + xslt_transform は、リソースAPIを使用すること + なく、Sablotron のより高度な機能へのインターフェースを提供します。