cvs: phpdoc /ja/functions gettext.xml gmp.xml http.xml hw.xml ibase.xml icap.xml iconv.xml ifx.xml image.xml

hirokawa Sun Jan 20 00:07:01 2002 EDT Modified files: /phpdoc/ja/functions gettext.xml gmp.xml http.xml hw.xml ibase.xml icap.xml iconv.xml ifx.xml image.xml Log: translation updated.

Index: phpdoc/ja/functions/gettext.xml diff -u phpdoc/ja/functions/gettext.xml:1.8 phpdoc/ja/functions/gettext.xml:1.9 --- phpdoc/ja/functions/gettext.xml:1.8 Wed Dec 12 15:52:58 2001 +++ phpdoc/ja/functions/gettext.xml Sun Jan 20 00:07:01 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.gettext"> <title>GNU Gettext</title> <titleabbrev>gettext</titleabbrev> @@ -32,6 +33,29 @@ </refsect1> </refentry> + <refentry id='function.bind-textdomain-codeset'> + <refnamediv> + <refname>bind_textdomain_codeset</refname> + <refpurpose> + DOMAINメッセージカタログからのメッセージが変更される文字エンコー + ディングを指定する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>bind_textdomain_codeset</function></funcdef> + <paramdef>string <parameter>domain</parameter></paramdef> + <paramdef>string <parameter>codeset</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.dcgettext"> <refnamediv> <refname>dcgettext</refname> @@ -54,6 +78,30 @@ </refsect1> </refentry> + <refentry id='function.dcngettext'> + <refnamediv> + <refname>dcngettext</refname> + <refpurpose> + dcgettext()の複数版</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dcngettext</function></funcdef> + <paramdef>string <parameter>domain</parameter></paramdef> + <paramdef>string <parameter>msgid1</parameter></paramdef> + <paramdef>string <parameter>msgid2</parameter></paramdef> + <paramdef>int <parameter>n</parameter></paramdef> + <paramdef>int <parameter>category</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.dgettext"> <refnamediv> <refname>dgettext</refname> @@ -69,8 +117,30 @@ </funcprototype> </funcsynopsis> <para> - 関数<function>dgettext</function>により - 単一のメッセージ参照についてカレントのドメインを上書きすることができます。 + 関数<function>dgettext</function>により単一のメッセージ参照につい + てカレントのドメインを上書きすることができます。 + </para> + </refsect1> + </refentry> + + <refentry id='function.dngettext'> + <refnamediv> + <refname>dcngettext</refname> + <refpurpose>dcgettext()の複数型です</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dcngettext</function></funcdef> + <paramdef>string <parameter>domain</parameter></paramdef> + <paramdef>string <parameter>msgid1</parameter></paramdef> + <paramdef>string <parameter>msgid2</parameter></paramdef> + <paramdef>int <parameter>n</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> @@ -96,7 +166,8 @@ <example> <title><function>gettext</function>-check</title> <programlisting> -&lt;?php +<![CDATA[ +<?php // ドイツ語に設定する putenv ("LANG=de"); @@ -109,8 +180,30 @@ // テストメッセージを出力する print (gettext ("Welcome to My PHP Application")); ?> +]]> </programlisting> </example> + </refsect1> + </refentry> + + <refentry id="function.ngettext"> + <refnamediv> + <refname>ngettext</refname> + <refpurpose>gettextの複数版</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ngettext</function></funcdef> + <paramdef>string <parameter>msgid1</parameter></paramdef> + <paramdef>string <parameter>msgid2</parameter></paramdef> + <paramdef>int <parameter>n</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> </refsect1> </refentry> Index: phpdoc/ja/functions/gmp.xml diff -u phpdoc/ja/functions/gmp.xml:1.8 phpdoc/ja/functions/gmp.xml:1.9 --- phpdoc/ja/functions/gmp.xml:1.8 Wed Dec 12 15:52:59 2001 +++ phpdoc/ja/functions/gmp.xml Sun Jan 20 00:07:01 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.gmp"> <title>GMP 関数</title> <titleabbrev>GMP</titleabbrev> @@ -39,16 +40,18 @@ <example> <title>GMP を使用した階乗関数</title> <programlisting role="php"> -&lt;?php -function fact($x) { - if($x &lt;= 1) +<![CDATA[ +<?php +function fact ($x) { + if ($x <= 1) return 1; - else - return gmp_mul($x,fact($x-1)); + else + return gmp_mul ($x, fact ($x-1)); } -print gmp_strval(fact(1000))."\n"; +print gmp_strval (fact (1000)) . "\n"; ?> +]]> </programlisting> </example> この例は、1000の階乗(非常に大きな数です)を非常に高速に計算します。 @@ -77,10 +80,12 @@ <example> <title>GMP 数を生成する</title> <programlisting role="php"> -&lt;?php - $a = gmp_init(123456); - $b = gmp_init("0xFFFFDEBACDFEDF7200"); +<![CDATA[ +<?php + $a = gmp_init (123456); + $b = gmp_init ("0xFFFFDEBACDFEDF7200"); ?> +]]> </programlisting> </example> </para> @@ -149,10 +154,12 @@ <example> <title>GMP 数を文字列に変換する</title> <programlisting role="php"> -&lt;?php - $a = gmp_init("0x41682179fbf5"); - printf("Decimal: %s, 36-based: %s", gmp_strval($a), gmp_strval($a,36)); +<![CDATA[ +<?php + $a = gmp_init("0x41682179fbf5"); + printf ("Decimal: %s, 36-based: %s", gmp_strval($a), gmp_strval($a,36)); ?> +]]> </programlisting> </example> </para> @@ -344,11 +351,14 @@ <example> <title>GMP 数の割算</title> <programlisting role="php"> -&lt;?php - $a = gmp_init("0x41682179fbf5"); - $res = gmp_div_qr($a, "0xDEFE75"); - printf("Result is: q - %s, r - %s", gmp_strval($res[0]), gmp_strval($res[1])); +<![CDATA[ +<?php + $a = gmp_init ("0x41682179fbf5"); + $res = gmp_div_qr ($a, "0xDEFE75"); + printf("Result is: q - %s, r - %s", + gmp_strval ($res[0]), gmp_strval ($res[1])); ?> +]]> </programlisting> </example> </para> @@ -461,6 +471,27 @@ </funcsynopsis> <para> -<parameter>a</parameter> を返します。 + </para> + </refsect1> + </refentry> + + <refentry id='function.gmp-com'> + <refnamediv> + <refname>gmp_com</refname> + <refpurpose> + aの補数を計算する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>gmp_com</function></funcdef> + <paramdef>resource <parameter>a</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> Index: phpdoc/ja/functions/http.xml diff -u phpdoc/ja/functions/http.xml:1.17 phpdoc/ja/functions/http.xml:1.18 --- phpdoc/ja/functions/http.xml:1.17 Wed Dec 12 15:53:00 2001 +++ phpdoc/ja/functions/http.xml Sun Jan 20 00:07:01 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.18 $ --> <reference id="ref.http"> <title>HTTP関連の関数</title> <titleabbrev>HTTP</titleabbrev> @@ -41,8 +42,10 @@ じ型の複数のヘッダを強制的に生成します。例えば、 <informalexample> <programlisting role="php"> -header('www-authenticate: Negociate'); -header('www-authenticate: NTLM',false); +<![CDATA[ +header('WWW-Authenticate: Negotiate'); +header('WWW-Authenticate: NTLM',false); +]]> </programlisting> </informalexample> </para> @@ -54,40 +57,97 @@ 人にとっては、理解しておくべき重要なこととなります。 <informalexample> <programlisting role="php"> +<![CDATA[ header("Location: http://www.php.net/"); /* ブラウザをPHP Web サイトに リダイレクトする */ exit; /* リダイレクトを行う際に以下のコードが 実行されないようにする */ +]]> </programlisting> </informalexample> </para> - <para> - 2番目の特別なヘッダは、文字列&quot;HTTP/&quot;から始まる全てのヘ - ッダ(大文字・小文字は区別されません)です。例えば、 - ApacheディレクティブErrorDocument 404であるPHPスクリプトを指定し - ている場合、そのPHPスクリプトがステータスコード404を生成するよう - にすると良いでしょう。この場合、そのスクリプトの中に以下のように - 記述します。 + <note> + <para> + HTTP/1.1では、スキーム、ホスト名、絶対パスを含む絶対 + <acronym>URI</acronym>が<ulink + url="&spec.http1.1;-sec14.html#sec14.30">Location:</ulink> + の引数として必要ですが、いくつかのクライアントでは相対URIも受け + つけます。通常、相対URIから絶対URIを作成するために + $HTTP_SERVER_VARS['HTTP_HOST'],$HTTP_SERVER_VARS['PHP_SELF'], + <function>dirname</function>を使用することが可能です。 + <informalexample> + <programlisting> +<![CDATA[ +header("Location: http://".$HTTP_SERVER_VARS['HTTP_HOST'] + ."/".dirname($HTTP_SERVER_VARS['PHP_SELF']) + ."/".$relative_url); +]]> + </programlisting> + </informalexample> + </para> + </note> + <para> + 2番目の特別なヘッダは、文字列&quot;<literal>HTTP/</literal>&quot; + から始まる全てのヘッダ(大文字・小文字は区別されません)です。この + ヘッダは、送信するHTTPステータスコードを示すために使用されます。 + 例えば、存在しないファイルへのリクエストを処理するためにあるPHPスクリ + プトを使用するよう(<literal>ErrorDocument</literal>ディレクティブ + により)Apacheを設定する場合、そのスクリプトが正しいステータスコー + ドを返すようにする必要があります。 <informalexample> <programlisting role="php"> -header ("HTTP/1.0 404 Not Found"); +<![CDATA[ +header("HTTP/1.0 404 Not Found"); +]]> </programlisting> </informalexample> - </para> - <para> - PHP スクリプトはしばしば動的に HTML を生成するため、クライアントブラウザや - サーバーおよびクライアントブラウザの間でプロキシがキャッシュを行ったり - するべきではありません。多くのプロキシとクライアントは、以下のコードにより - 強制的にキャッシュを無効にできます。 + <note> + <para> + PHP 3では、このコードは、PHPがApacheモジュール版としてコンパイ + ルされている場合にのみ動作します。<literal>Status</literal>ヘッ + ダを用いて同じ効果を得ることが可能です。 + <informalexample> + <programlisting role="php"> +<![CDATA[ +header("Status: 404 Not Found"); +]]> + </programlisting> + </informalexample> + </para> + </note> + </para> + <para> + PHPスクリプトはしばしば動的に HTML を生成するため、クライアントブ + ラウザやサーバーおよびクライアントブラウザの間でプロキシがキャッ + シュを行ったりするべきではありません。多くのプロキシとクライアン + トでは、以下のコードにより強制的にキャッシュを無効にできます。 <informalexample> <programlisting role="php"> -header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // 過去の日付 -header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT"); - // 常に修正されている -header("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1 -header("Pragma: no-cache"); // HTTP/1.0 +<![CDATA[ +header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // 日付が過去 +header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT"); + // 常に修正されている +header("Cache-Control: no-store, no-cache, must-revalidate"); // HTTP/1.1 +header("Cache-Control: post-check=0, pre-check=0", false); +header("Pragma: no-cache"); // HTTP/1.0 +]]> </programlisting> </informalexample> + <note> + <para> + 上記のヘッダを全て出力しなかったとしてもページのキャッシュが行 + われない場合があることに気付くかもしれません。デフォルトのブラ + ウザのキャッシュの動作をユーザが変更できる手段はいくつもありま + す。上記のヘッダを送信することにより、スクリプトの出力がキャッ + シュされる可能性がある設定を上書きするべきです。 + </para> + <para> + 加えて、<function>session_cache_limiter</function>および + 設定<literal>session.cache_limiter</literal>をセッションが使用 + された際にキャッシュ関係のヘッダを正しく自動的に生成するために + 使用できます。 + </para> + </note> </para> <para> 覚えておいて頂きたいのは、<function>header</function> 関数は、通 @@ -102,16 +162,59 @@ <para> <informalexample> <programlisting role="php"> -&lt;?php require("user_logging.inc") ?> +<![CDATA[ +<?php require("user_logging.inc") ?> -&lt;?php header ("Content-Type: audio/x-pn-realaudio"); ?> +<?php header ("Content-type: audio/x-pn-realaudio"); ?> // 動作しません。上の空行に注意して下さい。 +]]> </programlisting> </informalexample> + <note> + <para> + PHP 4では、この問題に対処するために出力のバッファリングを使用す + ることが可能です。この場合、ブラウザへの出力が送信するまでサー + バに全てバッファリングされるオーバーヘッドがあります。出力バッ + ファリングは、<function>ob_start</function>と + <function>ob_end_flush</function>をスクリプトでコールするか + <filename>php.ini</filename>またはサーバ設定ファイルの設定ディ + レクティブ<literal>output_buffering</literal>を設定することによ + り行うことが可能です。 + </para> + </note> </para> <para> - <function>headers_sent</function>も参照下さい。 + PDFファイルを生成するといったように送信するデータを保存するかどう + かユーザにプロンプトを表示したい場合、推奨されるファイル名を指定 + してブラウザに保存ダイアログを表示させる<ulink + url="&url.rfc2183;">Content-Disposition</ulink>ヘッダを使用可能で + す。 + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +header("Content-type: application/pdf"); +header("Content-Disposition: attachment; filename=downloaded.pdf"); + +/* ... PDFファイルを出力 ... */ +]]> + </programlisting> + </informalexample> + <note> + <para> + Microsoft Internet Explorer 4.01にはこれが動作しないというバグ + があります。この解決策はありません。Microsoft Internet Explorer + 5.5にもこれを妨げるバグがあります。これは、サービスパック2以降 + とすることで修整可能です。 + </para> + </note> + </para> + <para> + <function>headers_sent</function>, + <function>setcookie</function>及び + <link linkend="features.http-auth">HTTP認証</link>の節も参照下さ + い。 </para> </refsect1> </refentry> @@ -126,7 +229,7 @@ <funcsynopsis> <funcprototype> <funcdef>boolean <function>headers_sent</function></funcdef> - <paramdef><parameter>void</parameter></paramdef> + <void/> </funcprototype> </funcsynopsis> <para> @@ -231,9 +334,11 @@ <example> <title><function>setcookie</function>による送信の例</title> <programlisting role="php"> +<![CDATA[ setcookie ("TestCookie", "Test Value"); setcookie ("TestCookie", $value,time()+3600); /* 1時間で期限切れ */ setcookie ("TestCookie", $value,time()+3600, "/~rasmus/", ".utoronto.ca", 1); +]]> </programlisting> </example> </para> @@ -242,10 +347,12 @@ <example> <title><function>setcookie</function>による削除の例</title> <programlisting role="php"> +<![CDATA[ setcookie ("TestCookie"); // 有効期限を1時間前に設定する setcookie ("TestCookie", "", time() - 3600); setcookie ("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1); +]]> </programlisting> </example> クッキーを削除する場合には、ブラウザの削除機構を起動するために必 @@ -259,8 +366,10 @@ の例のうちの一つを使用して下さい。 <informalexample> <programlisting role="php"> +<![CDATA[ echo $TestCookie; echo $HTTP_COOKIE_VARS["TestCookie"]; +]]> </programlisting> </informalexample> </para> @@ -271,14 +380,16 @@ に置きかえられます。 <informalexample> <programlisting role="php"> +<![CDATA[ setcookie ("cookie[three]", "cookiethree"); setcookie ("cookie[two]", "cookietwo"); setcookie ("cookie[one]", "cookieone"); if (isset ($cookie)) { while (list ($name, $value) = each ($cookie)) { - echo "$name == $value&lt;br&gt;\n"; + echo "$name == $value<br>\n"; } } +]]> </programlisting> </informalexample> </para> Index: phpdoc/ja/functions/hw.xml diff -u phpdoc/ja/functions/hw.xml:1.12 phpdoc/ja/functions/hw.xml:1.13 --- phpdoc/ja/functions/hw.xml:1.12 Wed Dec 12 15:53:00 2001 +++ phpdoc/ja/functions/hw.xml Sun Jan 20 00:07:01 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.13 $ --> <reference id="ref.hyperwave"> <title>Hyperwave 関数</title> <titleabbrev>Hyperwave</titleabbrev> @@ -307,7 +308,9 @@ に簡単です。 <informalexample> <programlisting role="apache-conf"> +<![CDATA[ RewriteRule ^/(.*) /usr/local/apache/htdocs/HyperWave/$1 [L] +]]> </programlisting> </informalexample> この状態で、全ての URL は Hyperwave サーバーのオブジェクトに @@ -318,7 +321,9 @@ <informalexample> <programlisting role="apache-conf"> +<![CDATA[ RewriteRule ^/hw/(.*) /usr/local/apache/htdocs/hw/$1 [L] +]]> </programlisting> </informalexample> @@ -336,7 +341,9 @@ <informalexample> <programlisting role="apache-conf"> +<![CDATA[ RewriteEngine on +]]> </programlisting> </informalexample> @@ -473,10 +480,11 @@ </funcprototype> </funcsynopsis> <para> - オブジェクトレコードの配列を返します。 - 各オブジェクトレコードは、ID <parameter>objectID</parameter> - を有するコレクションの子に属しています。 - 配列は、ドキュメントおよびコレクションの全ての子を有しています。</para> + オブジェクトレコードの配列を返します。各オブジェクトレコードは、ID + <parameter>objectID</parameter>を有するコレクションの子に属してい + ます。配列は、ドキュメントおよびコレクションの全ての子を有していま + す。 + </para> </refsect1> </refentry> @@ -494,9 +502,10 @@ </funcprototype> </funcsynopsis> <para> - connection が有効な接続インデックスでない場合に &false;、それ以外の場合に - &true; を返します。 - 指定した接続インデックスに関して Hyperwave サーバーとの接続を閉じます。</para> + connectionが有効な接続インデックスでない場合に&false;、それ以外の + 場合に&true;を返します。指定した接続インデックスに関してHyperwave + サーバーとの接続を閉じます。 + </para> </refsect1> </refentry> @@ -517,18 +526,20 @@ </funcprototype> </funcsynopsis> <para> - Hyperwave サーバーへの接続をオープンし、成功した場合に接続インデックス、 - 接続できなかった場合に &false; を返します。 - 各引数は、ポート番号を除き引用符付の文字列である必要があります。 - <parameter>username</parameter> および <parameter>password</parameter> - 引数はオプションであり、省略することができます。 - この場合、サーバーによるユーザー識別は行われません。 - これは、匿名ユーザーとして識別されることに似ています。 - この関数は、他の Hyperwave 関数で必要な接続インデックスを返します。 - 複数の接続を同時にオープンすることが可能です。パスワードは暗号化されないこと - を覚えておいて下さい。</para> + Hyperwave サーバーへの接続をオープンし、成功した場合に接続インデッ + クス、接続できなかった場合に&false;を返します。各引数は、ポート番 + 号を除き引用符付の文字列である必要があります。 + <parameter>username</parameter>および + <parameter>password</parameter>引数はオプションであり、省略するこ + とができます。この場合、サーバーによるユーザー識別は行われません。 + これは、匿名ユーザーとして識別されることに似ています。この関数は、 + 他の Hyperwave 関数で必要な接続インデックスを返します。複数の接続 + を同時にオープンすることが可能です。パスワードは暗号化されないこと + を覚えておいて下さい。 + </para> <para> - <function>hw_pConnect</function> も参照下さい。</para> + <function>hw_pConnect</function> も参照下さい。 + </para> </refsect1> </refentry> @@ -972,20 +983,18 @@ </funcprototype> </funcsynopsis> <para> - リモートドキュメントを返します。Hyperwave 表記のリモートドキュメントは、 - 外部ソースから取得されたドキュメントです。 - 一般的なリモートドキュメントは、例えば外部Webページまたはデータベース - のクエリーです。 - 外部ソースをアクセス可能とするために、Hyperwave では CGI に似た HGI - (Hyperwave Gateway Interface)を導入しています。 - 現在、 ftp, http サーバーといくつかのデータベースのみが HGI により - アクセス可能です。 - <function>hw_GetRemote</function> をコールすることにより外部ソースからの - ドキュメントが返されます。 - この関数を使用したい場合、HGI を熟知している必要があります。 - 外部ソースをアクセスするために Hyperwave のかわりに PHP を使用することも - 考慮する必要があります。Hyperwave ゲートウエイにデータベースのサポートを - 付加するのは、PHPにおいて同じことを行うよりもより困難です。 + リモートドキュメントを返します。Hyperwave 表記のリモートドキュメ + ントは、外部ソースから取得されたドキュメントです。一般的なリモー + トドキュメントは、例えば外部Webページまたはデータベースのクエリー + です。外部ソースをアクセス可能とするために、HyperwaveではCGIに似 + たHGI(Hyperwave Gateway Interface)を導入しています。現在、 + ftp,httpサーバーといくつかのデータベースのみがHGIによりアクセス可 + 能です。<function>hw_GetRemote</function>をコールすることにより外 + 部ソースからのドキュメントが返されます。この関数を使用したい場合、 + HGIを熟知している必要があります。外部ソースをアクセスするために + HyperwaveのかわりにPHPを使用することも考慮する必要があります。 + Hyperwaveゲートウエイにデータベースのサポートを付加するのは、PHP + において同じことを行うよりもより困難です。 </para> <para> <function>hw_GetRemoteChildren</function> も参照下さい。 @@ -1781,11 +1790,13 @@ <example> <title>属性を修正する</title> <programlisting role="php"> +<![CDATA[ // $connect は、Hyperwave サーバーへの既存の接続です。 // $objid は、修正するオブジェクトのIDです。 $remarr = array("Name" => "books"); $addarr = array("Name" => "articles"); $hw_modifyobject($connect, $objid, $remarr, $addarr); +]]> </programlisting> </example> 名前=値の組を削除/追加するためには、オブジェクトレコードをremove/add @@ -1795,11 +1806,13 @@ <example> <title>完全に新規の属性を追加する</title> <programlisting role="php"> +<![CDATA[ // $connect は、Hyperwave サーバーへの既存の接続です。 // $objid は、修正するオブジェクトのIDです。 $remarr = array("Name" => 0); $addarr = array("Name" => "articles"); $hw_modifyobject($connect, $objid, $remarr, $addarr); +]]> </programlisting> </example> </para> @@ -1816,18 +1829,22 @@ <example> <title>Title 属性を修正する</title> <programlisting role="php"> +<![CDATA[ $remarr = array("Title" => "en:Books"); $addarr = array("Title" => "en:Articles"); $hw_modifyobject($connect, $objid, $remarr, $addarr); +]]> </programlisting> </example> または <example> <title>Title 属性を修正する</title> <programlisting role="php"> +<![CDATA[ $remarr = array("Title" => array("en" => "Books")); $addarr = array("Title" => array("en" => "Articles", "ge"=>"Artikel")); $hw_modifyobject($connect, $objid, $remarr, $addarr); +]]> </programlisting> </example> この例では、英語のタイトル 'Books' を削除し、 @@ -1836,9 +1853,11 @@ <example> <title>属性を削除する</title> <programlisting role="php"> +<![CDATA[ $remarr = array("Title" => ""); $addarr = array("Title" => "en:Articles"); $hw_modifyobject($connect, $objid, $remarr, $addarr); +]]> </programlisting> </example> <note> @@ -2132,6 +2151,165 @@ </funcsynopsis> <para> 接続を行っているユーザー名を返します。 + </para> + </refsect1> + </refentry> + + <refentry id='function.hw-stat'> + <refnamediv> + <refname>hw_stat</refname> + <refpurpose> + ステータス文字列を返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>hw_stat</function></funcdef> + <paramdef>int <parameter>link</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.hw-setlinkroot'> + <refnamediv> + <refname>hw_setlinkroot</refname> + <refpurpose> + 計算されたリンクのIDを設定する + Set the id to which links are calculated + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>hw_setlinkroot</function></funcdef> + <paramdef>int <parameter>link</parameter></paramdef> + <paramdef>int <parameter>rootid</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.hw-connection-info'> + <refnamediv> + <refname>hw_connection_info</refname> + <refpurpose> + Hyperwaveサーバへの接続に関する情報を出力する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>hw_connection_info</function></funcdef> + <paramdef>int <parameter>link</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.hw-dummy'> + <refnamediv> + <refname>hw_dummy</refname> + <refpurpose> + Hyperwaveダミー関数 + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>hw_dummy</function></funcdef> + <paramdef>int <parameter>link</parameter></paramdef> + <paramdef>int <parameter>id</parameter></paramdef> + <paramdef>int <parameter>msgid</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.hw-insertanchors'> + <refnamediv> + <refname>hw_insertanchors</refname> + <refpurpose> + textにアンカーのみを挿入する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>hw_insertanchors</function></funcdef> + <paramdef>int <parameter>hwdoc</parameter></paramdef> + <paramdef>array <parameter>anchorecs</parameter></paramdef> + <paramdef>array <parameter>dest</parameter></paramdef> + <paramdef>array <parameter><optional>urlprefixes</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.hw-getrellink'> + <refnamediv> + <refname>hw_getrellink</refname> + <refpurpose> + rootidに相対的なsourceからdestへのリンクを得る + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>hw_getrellink</function></funcdef> + <paramdef>int <parameter>link</parameter></paramdef> + <paramdef>int <parameter>rootid</parameter></paramdef> + <paramdef>int <parameter>sourceid</parameter></paramdef> + <paramdef>int <parameter>destid</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.hw-changeobject'> + <refnamediv> + <refname>hw_changeobject</refname> + <refpurpose> + オブジェクトの属性を変更する(古い関数) + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>hw_changeobject</function></funcdef> + <paramdef>int <parameter>link</parameter></paramdef> + <paramdef>int <parameter>objid</parameter></paramdef> + <paramdef>array <parameter>attributes</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> Index: phpdoc/ja/functions/ibase.xml diff -u phpdoc/ja/functions/ibase.xml:1.16 phpdoc/ja/functions/ibase.xml:1.17 --- phpdoc/ja/functions/ibase.xml:1.16 Wed Dec 12 15:53:02 2001 +++ phpdoc/ja/functions/ibase.xml Sun Jan 20 00:07:01 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.17 $ --> <reference id="ref.ibase"> <title>InterBase関数</title> <titleabbrev>InterBase</titleabbrev> @@ -14,6 +15,18 @@ <para> InterBase 6の完全なサポートがPHP 4.0で追加されました。 </para> + <para> + このデータベースは、シングルクオート(')文字をエスケープに使用しま + す。この動作はSybaseデータベースに似ており、以下のディレクティブ + を<filename>php.ini</filename>に追加して下さい。 + <informalexample> + <programlisting> +<![CDATA[ +magic_quotes_sybase = On +]]> + </programlisting> + </informalexample> + </para> </note> </partintro> @@ -63,23 +76,22 @@ </funcprototype> </funcsynopsis> <para> - InterBaseサーバーへの接続を確立します。 - 引数<parameter>database</parameter>は接続するサーバー上の - データベースファイルへの正しいパスである必要があります。 - ローカルなサーバーへの接続でない場合、使用する接続プロトコルに応じて - この引数の前に - 'hostname:' (TCP/IP)、'//hostname/' (NetBEUI)、'hostname@' (IPX/SPX) - のどれかをつける必要があります。 - <parameter>username</parameter>および<parameter>password</parameter> - はPHP設定ディレクティブibase.default_user - およびibase.default_passwordで指定することも可能です。 - <parameter>charset</parameter>はデータベースに関するデフォルトの - 文字セットです。 <parameter>buffers</parameter>は - サーバー側のキャッシュに確保されるデータベースバッファの数です。 - 0または省略された場合、サーバーはデフォルト値を用います。 - <parameter>dialect</parameter>は、接続時に実行される全ての命令に関する - SQL方言のデフォルト値を選択し、デフォルトではクライアントライブラリでサポート - される方言のうち、最高位のものになります。 + InterBaseサーバーへの接続を確立します。引数 + <parameter>database</parameter>は接続するサーバー上のデータベース + ファイルへの正しいパスである必要があります。ローカルなサーバーへ + の接続でない場合、使用する接続プロトコルに応じてこの引数の前に' + hostname:' (TCP/IP)、'//hostname/' (NetBEUI)、'hostname@' + (IPX/SPX)のどれかをつける必要があります。 + <parameter>username</parameter>および + <parameter>password</parameter>はPHP設定ディレクティブ + ibase.default_userおよびibase.default_passwordで指定することも可 + 能です。<parameter>charset</parameter>はデータベースに関するデフォ + ルトの文字セットです。 <parameter>buffers</parameter>はサーバー側 + のキャッシュに確保されるデータベースバッファの数です。0または省略 + された場合、サーバーはデフォルト値を用います。 + <parameter>dialect</parameter>は、接続時に実行される全ての命令に + 関するSQL方言のデフォルト値を選択し、デフォルトではクライアントラ + イブラリでサポートされる方言のうち、最高位のものになります。 </para> <para> 同じ引数で<function>ibase_connect</function>が再度コールされた場合、 @@ -90,32 +102,35 @@ <example> <title><function>ibase_connect</function>の例</title> <programlisting role="php"> -&lt;?php - $dbh = ibase_connect ($host, $username, $password); - $stmt = 'SELECT * FROM tblname'; - $sth = ibase_query ($dbh, $stmt); - while ($row = ibase_fetch_object ($sth)) { - print $row->email . "\n"; - } - ibase_close ($dbh); +<![CDATA[ +<?php + $dbh = ibase_connect($host, $username, $password); + $stmt = 'SELECT * FROM tblname'; + $sth = ibase_query($dbh, $stmt); + while ($row = ibase_fetch_object($sth)) { + echo $row->email, "\n"; + } + ibase_free_result($sth); + ibase_close($dbh); ?> +]]> </programlisting> </example> </para> <note> <para> - <parameter>buffers</parameter>はPHP 4-RC2で追加されました。 + <parameter>buffers</parameter>は、PHP 4.0RC2で追加されました。 </para> </note> <note> <para> - <parameter>dialect</parameter>はPHP 4-RC2で追加されました。 + <parameter>dialect</parameter>はPHP 4.0RC2で追加されました。 このオプションは、InterBase 6以降でのみ使用可能です。 </para> </note> <note> <para> - <parameter>role</parameter>はPHP 4-RC2で追加されました。 + <parameter>role</parameter>はPHP 4.0RC2で追加されました。 この機能は、InterBase 5以降でのみ使用可能です。 </para> </note> @@ -263,20 +278,38 @@ </funcprototype> </funcsynopsis> <simpara> - InterBaseデータベース上でクエリーを実行し、結果IDを返します。 - このIDは、<function>ibase_fetch_row</function>, + InterBaseデータベース上でクエリーを実行します。クエリが成功しない + 場合、&false;を返します。成功した場合、(SELECTクエリのような)結果 + の行がある場合、結果IDを返します。クエリが成功し、結果がない場合、 + &true;を返します。クエリが失敗した場合、 &false;が返されます。 + </simpara> + <para> + <function>ibase_errmsg</function>, + <function>ibase_fetch_row</function>, <function>ibase_fetch_object</function>, - <function>ibase_free_result</function>, - <function>ibase_free_query</function>で使用されます。 + <function>ibase_free_result</function>も参照下さい。 + </para> + </refsect1> + </refentry> + + <refentry id="function.ibase-errmsg"> + <refnamediv> + <refname>ibase_errmsg</refname> + <refpurpose> + エラーメッセージを返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ibase_errmsg</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <simpara> + エラーメッセージを有する文字列を返します。 </simpara> - <note> - <para> - この関数は、パラメータへの変数のバインドをサポートしていますが、 - この機能を使用する意味はあまりありません。 - 実用例については、<function>ibase_prepare</function>および - <function>ibase_execute</function>を参照下さい。 - </para> - </note> </refsect1> </refentry> @@ -323,7 +356,8 @@ 擬似オブジェクトとして1行分の結果を取得します。 <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<php $dbh = ibase_connect ($host, $username, $password); $stmt = 'SELECT * FROM tblname'; $sth = ibase_query ($dbh, $stmt); @@ -332,6 +366,7 @@ } ibase_close ($dbh); ?> +]]> </programlisting> </informalexample> </para> @@ -363,11 +398,10 @@ まれます。 <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 &lt; $coln ; $i++) { +<![CDATA[ +$rs=ibase_query("SELECT * FROM tablename"); +$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"; @@ -375,12 +409,36 @@ echo "length: ".$col_info['length']."\n"; echo "type: ".$col_info['type']."\n"; } +]]> </programlisting> </informalexample> </para> </refsect1> </refentry> + <refentry id="function.ibase-free-query"> + <refnamediv> + <refname>ibase_free_query</refname> + <refpurpose> + 準備されたクエリにより確保されたメモリを解放する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_free_query</function></funcdef> + <paramdef>int + <parameter>query</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>ibase_prepare</function>により準備されたクエリを解放します。 + </simpara> + </refsect1> + </refentry> + <refentry id="function.ibase-free-result"> <refnamediv> <refname>ibase_free_result</refname> @@ -424,8 +482,8 @@ </funcprototype> </funcsynopsis> <simpara> - 対応するパラメータのバインドや - (<function>ibase_execute</function>による)実行をするためのクエリを準備します。 + 対応するパラメータのバインドや(<function>ibase_execute</function> + による)実行をするためのクエリを準備します。 </simpara> </refsect1> </refentry> @@ -457,7 +515,8 @@ <function>ibase_query</function>を使用するよりもずっと効率的です。 <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $updates = array( 1 => 'Eric', 5 => 'Filip', @@ -470,6 +529,7 @@ ibase_execute($query, $bar, $baz); } ?> +]]> </programlisting> </informalexample> </para> @@ -556,29 +616,6 @@ </refsect1> </refentry> - <refentry id="function.ibase-free-query"> - <refnamediv> - <refname>ibase_free_query</refname> - <refpurpose> - 準備されたクエリにより確保されたメモリを解放する - </refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_free_query</function></funcdef> - <paramdef>int - <parameter>query</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>ibase_prepare</function>により準備されたクエリを解放します。 - </simpara> - </refsect1> - </refentry> - <refentry id="function.ibase-timefmt"> <refnamediv> <refname>ibase_timefmt</refname> @@ -602,25 +639,29 @@ </funcprototype> </funcsynopsis> <para> - クエリーから返されるtimestamp、data,time型カラムのフォーマットを設定します。 - 内部的にこれらのカラムはC言語の関数strftime()によりフォーマットされます。このため、 - 文字列のフォーマットについてはこのC言語の関数ドキュメントを参照下さい。 - <parameter>columntype</parameter>には定数IBASE_TIMESTAMP、IBASE_DATE、IBASE_TIME - のどれかを指定します。省略した場合には、下位互換性を保つため - IBASE_TIMESTAMPがデフォルト値となります。 + クエリーから返されるtimestamp、data,time型カラムのフォーマットを + 設定します。内部的にこれらのカラムはC言語の関数strftime()により + フォーマットされます。このため、文字列のフォーマットについてはこ + のC言語の関数ドキュメントを参照下さい。 + <parameter>columntype</parameter>には定数IBASE_TIMESTAMP、 + IBASE_DATE、IBASE_TIMEのどれかを指定します。省略した場合には、下 + 位互換性を保つためIBASE_TIMESTAMPがデフォルト値となります。 <informalexample> <programlisting role="php"> -&lt;?php - // InterBase 6 TIME型カラムが - // '05 hours 37 minutes'の形式で返されます - ibase_timefmt("%H hours %M minutes", IBASE_TIME); +<![CDATA[ +<?php +// InterBase 6 TIME型カラムが +// '05 hours 37 minutes'の形式で返されます +ibase_timefmt("%H hours %M minutes", IBASE_TIME); ?> +]]> </programlisting> </informalexample> </para> <para> - PHP設定ディレクティブibase.timestampformat、ibase.dateformat、ibase.timeformat - によりこれらのフォーマットのデフォルト値を設定することが可能です。 + PHP設定ディレクティブibase.timestampformat、ibase.dateformat、 + ibase.timeformatによりこれらのフォーマットのデフォルト値を設定す + ることが可能です。 </para> <note> <para> @@ -630,11 +671,11 @@ </note> <note> <para> - PHP 4.0では、PHP設定ディレクティブibase.timeformatがibase.timestampformatに - 名前が変更され、ディレクティブibase.dateformatとibase.timeformatが - 追加され、過去のバージョンとの互?性がない変更が行われています。 - この変更は、ディレクティブの名前がそれ自体の機能により一致するように - 行われたものです。 + PHP 4.0では、PHP設定ディレクティブibase.timeformatが + ibase.timestampformatに名前が変更され、ディレクティブ + ibase.dateformatとibase.timeformatが追加され、過去のバージョンと + の互換性がない変更が行われています。この変更は、ディレクティブの + 名前がそれ自体の機能により一致するように行われたものです。 </para> </note> </refsect1> @@ -659,7 +700,8 @@ 結果セットにおけるフィールド数を整数として返します。 <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $dbh = ibase_connect ($host, $username, $password); $stmt = 'SELECT * FROM tblname'; $sth = ibase_query ($dbh, $stmt); @@ -674,38 +716,209 @@ ibase_close ($dbh); ?> +]]> </programlisting> </informalexample> </para> <para> <function>ibase_field_info</function>も参照下さい。 </para> - <note> - <para> - <function>ibase_num_fields</function>は現在、PHP 4では動作しません。 - </para> - </note> </refsect1> </refentry> - <refentry id="function.ibase-errmsg"> + <refentry id='function.ibase-blob-add'> <refnamediv> - <refname>ibase_errmsg</refname> + <refname>ibase_blob_add</refname> <refpurpose> - エラーメッセージを返す + 生成されたblobにデータを追加する </refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>ibase_errmsg</function></funcdef> - <void/> + <funcdef>int <function>ibase_blob_add</function></funcdef> + <paramdef>int <parameter>blob_id</parameter></paramdef> + <paramdef>string <parameter>data</parameter></paramdef> </funcprototype> </funcsynopsis> - <simpara> - エラーメッセージを有する文字列を返します。 - </simpara> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-cancel'> + <refnamediv> + <refname>ibase_blob_cancel</refname> + <refpurpose> + blobの生成を取り消す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_blob_cancel</function></funcdef> + <paramdef>int <parameter>blob_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-close'> + <refnamediv> + <refname>ibase_blob_close</refname> + <refpurpose> + blobを閉じる + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_blob_close</function></funcdef> + <paramdef>int <parameter>blob_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-create'> + <refnamediv> + <refname>ibase_blob_create</refname> + <refpurpose> + データを追加するためにblobを生成する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_blob_create</function></funcdef> + <paramdef>int + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-echo'> + <refnamediv> + <refname>ibase_blob_echo</refname> + <refpurpose> + ブラウザにblobの内容を出力する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_blob_echo</function></funcdef> + <paramdef>string <parameter>blob_id_str</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-get'> + <refnamediv> + <refname>ibase_blob_get</refname> + <refpurpose> + オープンしたblobからデータのバイト数を取得する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ibase_blob_get</function></funcdef> + <paramdef>int <parameter>blob_id</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-import'> + <refnamediv> + <refname>ibase_blob_import</refname> + <refpurpose> + blobを生成し、ファイルをコピーし、閉じる + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ibase_blob_import</function></funcdef> + <paramdef>int + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + <paramdef>int <parameter>file_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-info'> + <refnamediv> + <refname>ibase_blob_info</refname> + <refpurpose> + blobの長さと他の便利な情報を返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>ibase_blob_info</function></funcdef> + <paramdef>string <parameter>blob_id_str</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.ibase-blob-open'> + <refnamediv> + <refname>ibase_blob_open</refname> + <refpurpose> + データの一部を取得するためにblobをオープンする + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_blob_open</function></funcdef> + <paramdef>string <parameter>blob_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> </refsect1> </refentry> Index: phpdoc/ja/functions/icap.xml diff -u phpdoc/ja/functions/icap.xml:1.8 phpdoc/ja/functions/icap.xml:1.9 --- phpdoc/ja/functions/icap.xml:1.8 Wed Dec 12 15:53:03 2001 +++ phpdoc/ja/functions/icap.xml Sun Jan 20 00:07:01 2002 @@ -1,17 +1,22 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.icap"> <title>ICAP 関数</title> <titleabbrev>ICAP</titleabbrev> - <partintro> <simpara> - これらの関数を動作させるためには、PHP を - <option role="configure">--with-icap</option> を付けてコンパイル - する必要があります。 - この際、icap ライブラリがインストールされている必要があります。 - <ulink url="&url.icap;">&url.icap;</ulink> より - 最新版を入手し、コンパイル、インストールしてください。 + これらの関数を動作させるためには、PHP を<option + role="configure">--with-icap</option> を付けてコンパイルする必要が + あります。この際、icap ライブラリがインストールされている必要があ + りますが、もはやサポートされてもおらず、取得可能でもありません。 </simpara> + <note> + <simpara> + icapは、近い将来削除されます。このモジュールはもicapライブラリも + もはやサポートされていません。カレンダ機能をPHPで使用したい場合は、 + 替わりに<link linkend="ref.mcal">mcal</link>を使用して下さい。 + </simpara> + </note> </partintro> <refentry id="function.icap-open"> @@ -443,6 +448,98 @@ </simpara> </listitem> </itemizedlist> + </para> + </refsect1> + </refentry> + + <refentry id='function.icap-create-calendar'> + <refnamediv> + <refname>icap_create_calendar</refname> + <refpurpose> + 新規カレンダを作成する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>icap_create_calendar</function></funcdef> + <paramdef>int <parameter>stream_id</parameter></paramdef> + <paramdef>string <parameter>calendar</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.icap-rename-calendar'> + <refnamediv> + <refname>icap_rename_calendar</refname> + <refpurpose> + カレンダの名前を変える + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>icap_rename_calendar</function></funcdef> + <paramdef>int <parameter>stream_id</parameter></paramdef> + <paramdef>string <parameter>old_name</parameter></paramdef> + <paramdef>string <parameter>new_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.icap-delete-calendar'> + <refnamediv> + <refname>icap_delete_calendar</refname> + <refpurpose> + カレンダを削除する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>icap_delete_calendar</function></funcdef> + <paramdef>int <parameter>stream_id</parameter></paramdef> + <paramdef>string <parameter>calendar</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.icap-reopen'> + <refnamediv> + <refname>icap_reopen</refname> + <refpurpose> + 新規カレンダへのICAPストリームを再オープンする + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>icap_reopen</function></funcdef> + <paramdef>int <parameter>stream_id</parameter></paramdef> + <paramdef>string <parameter>calendar</parameter></paramdef> + <paramdef>int + <parameter><optional>options</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> Index: phpdoc/ja/functions/iconv.xml diff -u phpdoc/ja/functions/iconv.xml:1.4 phpdoc/ja/functions/iconv.xml:1.5 --- phpdoc/ja/functions/iconv.xml:1.4 Wed Dec 12 15:53:03 2001 +++ phpdoc/ja/functions/iconv.xml Sun Jan 20 00:07:01 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <reference id="ref.iconv"> <title>iconv 関数</title> <titleabbrev>iconv</titleabbrev> @@ -50,7 +51,9 @@ <example> <title><function>iconv</function> の例</title> <programlisting role="php"> +<![CDATA[ echo iconv("ISO-8859-1","UTF-8","This is test."); +]]> </programlisting> </example> </para> @@ -110,8 +113,10 @@ <example> <title><function>iconv_set_encoding</function> の例</title> <programlisting role="php"> +<![CDATA[ iconv_set_encoding("internal_encoding", "UTF-8"); iconv_set_encoding("output_encoding", "ISO-8859-1"); +]]> </programlisting> </example> </para> @@ -156,7 +161,9 @@ <example> <title><function>ob_iconv_handler</function> の例</title> <programlisting role="php"> +<![CDATA[ ob_start("ob_iconv_handler"); // 出力バッファリングを開始 +]]> </programlisting> </example> </para> Index: phpdoc/ja/functions/ifx.xml diff -u phpdoc/ja/functions/ifx.xml:1.13 phpdoc/ja/functions/ifx.xml:1.14 --- phpdoc/ja/functions/ifx.xml:1.13 Wed Dec 12 15:53:04 2001 +++ phpdoc/ja/functions/ifx.xml Sun Jan 20 00:07:01 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> - +<!-- $Revision: 1.14 $ --> <reference id="ref.ifx"> <title>Informix 関数</title> <titleabbrev>Informix</titleabbrev> @@ -229,7 +229,9 @@ <example> <title>Informix データベースへの接続</title> <programlisting role="php"> +<![CDATA[ $conn_id = ifx_connect ("mydb@ol_srv1", "imyself", "mypassword"); +]]> </programlisting> </example> </para> @@ -334,9 +336,11 @@ <example> <title>Informix 接続を閉じる</title> <programlisting role="php"> +<![CDATA[ $conn_id = ifx_connect (mydb@ol_srv, "itsme", "mypassword"); ... クエリー等を実行 ... ifx_close($conn_id); +]]> </programlisting> </example> </para> @@ -430,6 +434,7 @@ <example> <title>"orders" テーブルの全行を HTML テーブルとして表示する</title> <programlisting role="php"> +<![CDATA[ ifx_textasvarchar(1); // BLOB 用に "text mode" を使用する $res_id = ifx_query("select * from orders", $conn_id); if (! $res_id) { @@ -440,26 +445,29 @@ } ifx_htmltbl_result($res_id, "border=\"1\""); ifx_free_result($res_id); +]]> </programlisting> </example> <example> <title>値を "catalog" テーブルに挿入する</title> <programlisting role="php"> - // バイトおよびテキストカラムに関する BLOB ID を作成する。 +<![CDATA[ +// バイトおよびテキストカラムに関する BLOB ID を作成する。 $textid = ifx_create_blob(0, 0, "Text column in memory"); $byteid = ifx_create_blob(1, 0, "Byte column in memory"); - // blob id を blobid 配列に保存 +// blob id を blobid 配列に保存 $blobidarray[] = $textid; $blobidarray[] = $byteid; - // クエリーを実行 +// クエリーを実行 $query = "insert into catalog (stock_num, manu_code, " . "cat_descr,cat_picture) values(1,'HRO',?,?)"; $res_id = ifx_query($query, $conn_id, $blobidarray); if (! $res_id) { - ... error ... + ... エラー ... } - // 結果 id を解放 +// 結果 id を解放 ifx_free_result($res_id); +]]> </programlisting> </example> </para> @@ -700,15 +708,18 @@ <example> <title>Informix affected rows</title> <programlisting role="php"> -$rid = ifx_prepare ("select * from emp where name like " . $name, $connid); +<![CDATA[ +$rid = ifx_prepare ("select * from emp + where name like " . $name, $connid); if (! $rid) { ... error ... } $rowcount = ifx_affected_rows ($rid); if ($rowcount > 1000) { - printf ("Too many rows in result set (%d)\n&lt;br>", $rowcount); - die ("Please restrict your query&lt;br>\n"); + printf ("Too many rows in result set (%d)\n<br>", $rowcount); + die ("Please restrict your query<br>\n"); } +]]> </programlisting> </example> </refsect1> @@ -752,6 +763,7 @@ <example> <title>Informix sqlca.sqlerrd[x] の値を取得する</title> <programlisting role="php"> +<![CDATA[ /* 'sometable' の最初のカラムは連番であると仮定する */ $qid = ifx_query("insert into sometable values(0, '2nd column', 'another column') ", $connid)); @@ -760,7 +772,8 @@ } $sqlca = ifx_getsqlca ($qid); $serial_value = $sqlca["sqlerrd1"]; -echo "挿入された行の続き番号は : " . "$serial_value&lt;br>\n"; +echo "挿入された行の続き番号は : " . "$serial_value<br>\n"; +]]> </programlisting> </example> </refsect1> @@ -801,8 +814,7 @@ により返された有効な結果 ID です。 </para> <para> - <parameter><replaceable><optional>position</optional></replaceable></parameter> - は、オプション + <parameter>position</parameter>は、オプション パラメータで、"スクロール" カーソルで "取得" 操作を行うためのもので、 次のようになります。 "NEXT", "PREVIOUS", "CURRENT", "FIRST", "LAST" ,または番号。 @@ -823,6 +835,7 @@ <example> <title>Informix 行の取得</title> <programlisting role="php"> +<![CDATA[ $rid = ifx_prepare ("select * from emp where name like " . $name, $connid, IFX_SCROLL); if (! $rid) { @@ -830,8 +843,8 @@ } $rowcount = ifx_affected_rows($rid); if ($rowcount > 1000) { - printf ("Too many rows in result set (%d)\n&lt;br>", $rowcount); - die ("Please restrict your query&lt;br>\n"); + printf ("Too many rows in result set (%d)\n<br>", $rowcount); + die ("Please restrict your query<br>\n"); } if (! ifx_do ($rid)) { ... error ... @@ -842,10 +855,11 @@ $fieldvalue = $row[$fieldname]; printf ("%s = %s,", $fieldname, $fieldvalue); } - printf("\n&lt;br>"); + printf("\n<br>"); $row = ifx_fetch_row ($rid, "NEXT"); } ifx_free_result ($rid); +]]> </programlisting> </example> </refsect1> @@ -882,6 +896,7 @@ <example> <title>Informix 結果を HTML テーブルとして出力</title> <programlisting role="php"> +<![CDATA[ $rid = ifx_prepare ("select * from emp where name like " . $name, $connid, IFX_SCROLL); if (! $rid) { @@ -889,8 +904,8 @@ } $rowcount = ifx_affected_rows ($rid); if ($rowcount > 1000) { - printf ("Too many rows in result set (%d)\n&lt;br>", $rowcount); - die ("Please restrict your query&lt;br>\n"); + printf ("Too many rows in result set (%d)\n<br>", $rowcount); + die ("Please restrict your query<br>\n"); } if (! ifx_do($rid) { ... error ... @@ -899,6 +914,7 @@ ifx_htmltbl_result ($rid, "border=\"2\""); ifx_free_result($rid); +]]> </programlisting> </example> </refsect1> @@ -925,15 +941,17 @@ <example> <title>フィールド名および SQL フィールド型</title> <programlisting role="php"> +<![CDATA[ $types = ifx_fieldtypes ($resultid); if (! isset ($types)) { ... エラー処理 ... } -for ($i = 0; $i &lt; count($types); $i++) { +for ($i = 0; $i < count($types); $i++) { $fname = key($types); printf("%s :\t type = %s\n", $fname, $types[$fname]); next($types); } +]]> </programlisting> </example> </refsect1> @@ -967,15 +985,17 @@ <example> <title>Informix SQL フィールドプロパティ</title> <programlisting role="php"> +<![CDATA[ $properties = ifx_fieldproperties ($resultid); if (! isset($properties)) { ... error ... } -for ($i = 0; $i &lt; count($properties); $i++) { +for ($i = 0; $i < count($properties); $i++) { $fname = key ($properties); printf ("%s:\t type = %s\n", $fname, $properties[$fname]); next ($properties); } +]]> </programlisting> </example> </refsect1> @@ -1518,10 +1538,10 @@ </funcprototype> </funcsynopsis> <para> - SLOB オブジェクトを文字列に書きこみます。<parameter>bid</parameter> - は存在する SLOB ID 、<parameter>content</parameter> は - 書きこむ内容です。 - エラーの 場合に &false;、その他の場合に書きこんだバイト数を返します。 + SLOBオブジェクトを文字列に書きこみます。 + <parameter>bid</parameter>は存在する SLOB ID 、 + <parameter>content</parameter> は書きこむ内容です。エラーの場合に + &false;、その他の場合に書きこんだバイト数を返します。 </para> </refsect1> </refentry> Index: phpdoc/ja/functions/image.xml diff -u phpdoc/ja/functions/image.xml:1.28 phpdoc/ja/functions/image.xml:1.29 --- phpdoc/ja/functions/image.xml:1.28 Wed Dec 12 15:53:05 2001 +++ phpdoc/ja/functions/image.xml Sun Jan 20 00:07:01 2002 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.29 $ --> <reference id="ref.image"> - <title>イメージ関数</title> - <titleabbrev>グラフィックス</titleabbrev> + <title>イメージ関数(image)</title> + <titleabbrev>イメージ</titleabbrev> <partintro> <simpara> @@ -70,8 +71,10 @@ <example> <title>GetImageSize (ファイル)</title> <programlisting role="php"> -&lt;?php $size = GetImageSize ("img/flag.jpg"); ?> -&lt;IMG SRC="img/flag.jpg" &lt;?php echo $size[3]; ?> +<![CDATA[ +<?php $size = GetImageSize ("img/flag.jpg"); ?> +<IMG SRC="img/flag.jpg" <?php echo $size[3]; ?> +]]> </programlisting> </example> </para> @@ -79,7 +82,9 @@ <example> <title>GetImageSize (URL)</title> <programlisting role="php"> -&lt;?php $size = GetImageSize ("http://www.php.net/gifs/logo.gif"); ?> +<![CDATA[ +<?php $size = GetImageSize ("http://www.php.net/gifs/logo.gif"); ?> +]]> </programlisting> </example> </para> @@ -96,13 +101,15 @@ <example> <title>IPTC を返す GetImageSize</title> <programlisting> - &lt;?php - $size = GetImageSize ("testimg.jpg",&amp;$info); - if (isset ($info["APP13"])) { - $iptc = iptcparse ($info["APP13"]); - var_dump ($iptc); - } - ?> +<![CDATA[ +<?php + $size = GetImageSize ("testimg.jpg",&$info); + if (isset ($info["APP13"])) { + $iptc = iptcparse ($info["APP13"]); + var_dump ($iptc); + } +?> +]]> </programlisting> </example> <note> @@ -119,6 +126,49 @@ </refsect1> </refentry> + <refentry id="function.image2wbmp"> + <refnamediv> + <refname>Image2WBMP</refname> + <refpurpose>ブラウザまたはファイルにイメージを出力する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>image2WBMP</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>string + <parameter><optional>filename</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>threshold</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Image2WBMP</function>は、イメージ + <parameter>im</parameter>からfilenameに<acronym>WBMP</acronym>ファ + イルを作成します。<parameter>im</parameter>引数は、 + <function>ImageCreate</function>から返されます。 + </para> + <para> + 引数filenameはオプションで、省略された場合には、生のイメージスト + リームが直接出力されます。<function>header</function>を用いて + <acronym>image/vnd.wap.wbmp</acronym> content-typeを送信すること + により、WBMPイメージに直接出力するPHPスクリプトを生成可能です。 + </para> + <note> + <para> + WBMPサポートは、GD-1.8以降でPHPをコンパイルされた場合のみ利用可能 + です。 + </para> + </note> + <para> + <function>ImageWBMP</function>も参照下さい。 + </para> + </refsect1> + </refentry> + <refentry id="function.imagealphablending"> <refnamediv> <refname>ImageAlphaBlending</refname> @@ -182,6 +232,11 @@ 方、始点と終点は引数<parameter>s</parameter>と <parameter>e</parameter>により度(deg)で指定します。 </para> + <para> + <function>ImageEllipse</function>, + <function>ImageFilledEllipse</function>, + <function>ImageFilledArc</function>も参照下さい。 + </para> </refsect1> </refentry> @@ -267,6 +322,9 @@ この関数はPHP 4.0.6で追加され、GD 2.0.1以降を必要とします。 </para> </note> + <para> + <function>ImageArc</function>も参照下さい。 + </para> </refsect1> </refentry> @@ -301,6 +359,9 @@ この関数はPHP 4.0.6で追加され、GD 2.0.1以降を必要とします。 </para> </note> + <para> + <function>ImageFilledArc</function>も参照下さい。 + </para> </refsect1> </refentry> @@ -392,8 +453,10 @@ 画像上で使用される各々の色を作成する際にコールする必要があります。 <informalexample> <programlisting role="php"> +<![CDATA[ $white = ImageColorAllocate ($im, 255, 255, 255); $black = ImageColorAllocate ($im, 0, 0, 0); +]]> </programlisting> </informalexample> </para> @@ -427,8 +490,10 @@ <function>ImageColorAllocate</function>で確保された色を開放します。 <informalexample> <programlisting role="php"> +<![CDATA[ $white = ImageColorAllocate($im, 255, 255, 255); ImageColorDeAllocate($im, $white); +]]> </programlisting> </informalexample> </para> @@ -526,6 +591,30 @@ </refsect1> </refentry> + <refentry id='function.imagecolorclosesthwb'> + <refnamediv> + <refname>ImageColorClosestThwb</refname> + <refpurpose> + 指定した色に最も近いhue、白、黒を有する色のインデックスを得る + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolorclosesthwb</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>red</parameter></paramdef> + <paramdef>int <parameter>green</parameter></paramdef> + <paramdef>int <parameter>blue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.imagecolorexact"> <refnamediv> <refname>ImageColorExact</refname> @@ -663,8 +752,8 @@ <funcprototype> <funcdef>int <function>imagegammacorrect</function></funcdef> <paramdef>int <parameter>im</parameter></paramdef> - <paramdef>double <parameter>inputgamma</parameter></paramdef> - <paramdef>double <parameter>outputgamma</parameter></paramdef> + <paramdef>float <parameter>inputgamma</parameter></paramdef> + <paramdef>float <parameter>outputgamma</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -856,6 +945,11 @@ 100の場合、この関数の動作は、<function>ImageCopy</function>と同じ となります。 </para> + <note> + <para> + この関数はPHP 4.0.6で追加されました。 + </para> + </note> </refsect1> </refentry> @@ -1023,15 +1117,17 @@ 新規にGDイメージストリームを作成し、イメージを出力します。 </title> <programlisting role="php"> -&lt;? +<![CDATA[ +<?php header ("Content-type: image/png"); $im = @ImageCreate (50, 100) - or die ("Cannot Initialize new GD image stream"); + or die ("Cannot Initialize new GD image stream"); $background_color = ImageColorAllocate ($im, 255, 255, 255); $text_color = ImageColorAllocate ($im, 233, 14, 91); ImageString ($im, 1, 5, 5, "A Simple Text String", $text_color); ImagePng ($im); ?> +]]> </programlisting> </example> </refsect1> @@ -1106,6 +1202,73 @@ </refsect1> </refentry> + <refentry id='function.imagecreatefromgd'> + <refnamediv> + <refname>ImageCreateFromGD</refname> + <refpurpose> + GDファイルまたはURLから新規イメージを生成する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefromgd</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.imagecreatefromgd2'> + <refnamediv> + <refname>ImageCreateFromGD2</refname> + <refpurpose> + GD2ファイルまたはURLから新規イメージを生成する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefromgd2</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.imagecreatefromgd2part'> + <refnamediv> + <refname>ImageCreateFromGD2Part</refname> + <refpurpose> + GD2ファイルまたはURLの指定した部分から新規イメージを生成する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefromgd2part</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>srcX</parameter></paramdef> + <paramdef>int <parameter>srcY</parameter></paramdef> + <paramdef>int <parameter>width</parameter></paramdef> + <paramdef>int <parameter>height</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.imagecreatefromgif"> <refnamediv> <refname>ImageCreateFromGif</refname> @@ -1133,18 +1296,20 @@ 作成時のエラーを処理する例 (vic@zymsys.com による) </title> <programlisting role="php"> - function LoadGif ($imgname) - { +<![CDATA[ +function LoadGif ($imgname) { $im = @imagecreatefromgif ($imgname); /* オープンを行う */ if (!$im) { /* 失敗したかどうかを調べる */ $im = ImageCreate (150,30); /* 空の画像を作成 */ $bgc = ImageColorAllocate ($im,255,255,255); $tc = ImageColorAllocate ($im,0,0,0); ImageFilledRectangle ($im,0,0,150,30,$bgc); - ImageString ($im,1,5,5,"Error loading $imgname",$tc); /* errmsg を出力 */ + /* errmsg を出力 */ + ImageString ($im,1,5,5,"Error loading $imgname",$tc); } return $im; } +]]> </programlisting> </example> <note> @@ -1184,8 +1349,8 @@ 作成時のエラーを処理する例 (vic@zymsys.comによる) </title> <programlisting role="php"> -function LoadJpeg ($imgname) -{ +<![CDATA[ +function LoadJpeg ($imgname) { $im = @imagecreatefromjpeg ($imgname); /* オープンを試みる */ if (!$im) { /* オープンに失敗した場合 */ $im = ImageCreate (150,30); /* 空の画像を作成 */ @@ -1196,6 +1361,7 @@ } return $im; } +]]> </programlisting> </example> </para> @@ -1230,8 +1396,8 @@ 作成時のエラーを処理する例(vic@zymsys.comによる) </title> <programlisting role="php"> -function LoadPNG ($imgname) -{ +<![CDATA[ +function LoadPNG ($imgname) { $im = @imagecreatefrompng ($imgname); /* オープンを試みる */ if (!$im) { /* 失敗した場合 */ $im = ImageCreate (150,30); /* 空の画像を作成 */ @@ -1242,6 +1408,7 @@ } return $im; } +]]> </programlisting> </example> </para> @@ -1279,6 +1446,7 @@ 作成時のエラーを処理する例 (vic@zymsys.com による) </title> <programlisting role="php"> +<![CDATA[ function LoadWBMP ($imgname) { $im = @ImageCreateFromWBMP ($imgname); /* オープンする */ if (!$im) { /* 失敗したかどうか判定 */ @@ -1291,9 +1459,16 @@ } return $im; } +]]> </programlisting> </example> </para> + <note> + <para> + WBMPサポートは、GD-1.8以降でコンパイルされたPHPでのみ利用可能で + す。 + </para> + </note> </refsect1> </refentry> @@ -1319,6 +1494,46 @@ </refsect1> </refentry> + <refentry id="function.imagecreatefromxbm"> + <refnamediv> + <refname>ImageCreateFromXBM</refname> + <refpurpose>ファイル又はURLから新規イメージを生成する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefromxbm</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ImageCreateFromXBM</function>は、指定したfilenameから得 + られたイメージを表すイメージIDを返します。 + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecreatefromxpm"> + <refnamediv> + <refname>ImageCreateFromXPM</refname> + <refpurpose>ファイルまたはURLから新規イメージを生成する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefromxpm</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ImageCreateFromXPM</function>は、指定したfilenameから得 + られたイメージを表すイメージIDを返します。 + </para> + </refsect1> + </refentry> + <refentry id="function.imagedashedline"> <refnamediv> <refname>ImageDashedLine</refname> @@ -1338,13 +1553,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ImageDashedLine</function>は、画像<parameter>im</parameter>に - (<parameter>x1</parameter>, <parameter>y1</parameter>)から - (<parameter>x2</parameter>, <parameter>y2</parameter>)まで(左上が0,0) - <parameter>col</parameter>色で破線を描画します。 - </para> - <para> - <function>imageline</function>も参考にしてください。 + これは古い関数です。替わりに<function>ImageSetStyle</function>と + <function>ImageLine</function>の組み合せを使用して下さい。 </para> </refsect1> </refentry> @@ -1523,6 +1733,54 @@ </refsect1> </refentry> + <refentry id='function.imagegd'> + <refnamediv> + <refname>ImageGD</refname> + <refpurpose> + GDイメージをブラウザまたはファイルに出力する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagegd</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>string + <parameter><optional>filename</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.imagegd2'> + <refnamediv> + <refname>ImageGD2</refname> + <refpurpose> + GD2イメージをブラウザまたはファイルに出力する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagegd2</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>string + <parameter><optional>filename</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.imagegif"> <refnamediv> <refname>ImageGif</refname> @@ -1572,7 +1830,8 @@ るコードに置換して下さい。 <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php if (function_exists("imagegif")) { Header("Content-type: image/gif"); ImageGIF($im); @@ -1592,7 +1851,8 @@ else { die("このPHPサーバーではイメージはサポートされていません"); } -?&gt; +?> +]]> </programlisting> </informalexample> </para> @@ -1605,12 +1865,14 @@ です。 <informalexample> <programlisting role="php"> -if (ImageTypes() &amp; IMG_GIF) { - Header ("Content-type: image/gif"); - ImageGif ($im); +<![CDATA[ +if (ImageTypes() & IMG_GIF) { + Header("Content-type: image/gif"); + ImageGif($im); } -elseif (ImageTypes() &amp; IMG_JPG) { +elseif (ImageTypes() & IMG_JPG) { ... 等。 +]]> </programlisting> </informalexample> </para> @@ -1653,8 +1915,12 @@ はそのファイルにイメージを出力します。 <informalexample> <programlisting role="php"> +<![CDATA[ +<?php $im = ImageCreateFromPng("test.png"); ImagePng($im); +?> +]]> </programlisting> </informalexample> </para> @@ -1907,6 +2173,31 @@ </refsect1> </refentry> + <refentry id="function.imagepalettecopy"> + <refnamediv> + <refname>ImagePaletteCopy</refname> + <refpurpose> + あるイメージから他のイメージにパレットをコピーする + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagepalettecopy</function></funcdef> + <paramdef>resource <parameter>destination</parameter></paramdef> + <paramdef>resource <parameter>source</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>imagepalettecopy</function>は、 + <parameter>source</parameter>イメージから + <parameter>destination</parameter>イメージにパレットをコピーしま + す。 + </para> + </refsect1> + </refentry> + <refentry id="function.imagepolygon"> <refnamediv> <refname>ImagePolygon</refname> @@ -2150,7 +2441,8 @@ </para> <para> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php Header ("Content-type: image/jpeg"); $im = ImageCreate (350, 45); $black = ImageColorAllocate ($im, 0, 0, 0); @@ -2162,7 +2454,8 @@ ImagePsFreeFont($font); ImageJpeg($im, "", 100);//for best quality... your mileage may vary ImageDestroy ($im); -?&gt; +?> +]]> </programlisting> </para> <para> @@ -2182,7 +2475,7 @@ <funcprototype> <funcdef>bool <function>imagepsextendfont</function> </funcdef> <paramdef>int <parameter>font_index</parameter></paramdef> - <paramdef>double <parameter>extend</parameter></paramdef> + <paramdef>float <parameter>extend</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2204,7 +2497,7 @@ <funcprototype> <funcdef>bool <function>imagepsslantfont</function></funcdef> <paramdef>int <parameter>font_index</parameter></paramdef> - <paramdef>double <parameter>slant</parameter></paramdef> + <paramdef>float <parameter>slant</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2234,10 +2527,18 @@ <paramdef>int <parameter>background</parameter></paramdef> <paramdef>int <parameter>x</parameter></paramdef> <paramdef>int <parameter>y</parameter></paramdef> - <paramdef>int <parameter>space</parameter></paramdef> - <paramdef>int <parameter>tightness</parameter></paramdef> - <paramdef>float <parameter>angle</parameter></paramdef> - <paramdef>int <parameter>antialias_steps</parameter></paramdef> + <paramdef>int + <parameter><optional>space</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>tightness</optional></parameter> + </paramdef> + <paramdef>float + <parameter><optional>angle</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>antialias_steps</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -2411,6 +2712,74 @@ </refsect1> </refentry> + <refentry id="function.imagesetstyle"> + <refnamediv> + <refname>ImageSetStyle</refname> + <refpurpose>線描画用のスタイルを設定する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagesetstyle</function></funcdef> + <paramdef>resource <parameter>im</parameter></paramdef> + <paramdef>array <parameter>style</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ImageSetStyle</function>は、特別な + <literal>IMG_COLOR_STYLED</literal>または色を有するイメージの線 + <literal>IMG_COLOR_STYLEDBRUSHED</literal>を描画する際に + (<function>ImageLine</function>と + <function>ImagePolygon</function>のような) + 全ての線描画関数で使用されるスタイルを設定します。 + </para> + <para> + パラメータ<parameter>style</parameter>はピクセルの配列です。以下 + の例は、キャンバスの左上から右下隅に破線を描画するスクリプトです。 + <example> + <title>ImageSetStyle</title> + <programlisting role="php"> +<![CDATA[ +<?php +Header ("Content-type: image/png"); +$im = imagecreate (100, 100); +$w = ImageColorAllocate ($im, 255, 255, 255); +$red = ImageColorAllocate ($im, 255, 0, 0); + +/* Draw a dashed line, 5 red pixels, 5 white pixels */ +$style=array($red,$red,$red,$red,$red,$w,$w,$w,$w,$w); +ImageSetStyle($im, $style); +ImageLine($im, 0, 0, 100, 100, IMG_COLOR_STYLED); + +/* Draw a line of happy faces using ImageSetBrush() with ImageSetStyle */ +$style=array($w,$w,$w,$w,$w,$w,$w,$w,$w,$w,$w,$w,$red); +ImageSetStyle($im, $style); + +$brush=ImageCreateFromPng("http://www.libpng.org/pub/png/images/smile.happy.png"); +ImageColorTransparent($brush, $w); +ImageSetBrush($im, $brush); +ImageLine($im, 100, 0, 0, 100, IMG_COLOR_STYLEDBRUSHED); + +ImagePng($im); +ImageDestroy ($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <function>ImageSetBrush</function>, + <function>ImageLine</function>も参照下さい。 + </para> + <note> + <para> + この関数は、PHP 4.0.6で追加されました。 + </para> + </note> + </refsect1> + </refentry> + <refentry id="function.imagesettile"> <refnamediv> <refname>ImageSetTile</refname> @@ -2704,6 +3073,33 @@ </refsect1> </refentry> + <refentry id='function.imageftbbox'> + <refnamediv> + <refname>ImageFtBBox</refname> + <refpurpose> + freetype2によるフォントを用いたテキストを囲む箱を取得する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>imageftbbox</function></funcdef> + <paramdef>int <parameter>size</parameter></paramdef> + <paramdef>int <parameter>angle</parameter></paramdef> + <paramdef>string <parameter>font_file</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + <paramdef>array + <parameter><optional>extrainfo</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.imagettftext"> <refnamediv> <refname>ImageTTFText</refname> @@ -2771,15 +3167,18 @@ <example> <title>ImageTTFText</title> <programlisting> -&lt;?php -Header("Content-type: image/gif"); -$im = imagecreate(400,30); -$black = ImageColorAllocate($im, 0,0,0); -$white = ImageColorAllocate($im, 255,255,255); -ImageTTFText($im, 20, 0, 10, 20, $white, "/path/arial.ttf", "Testing... Omega: &amp;#937;"); -ImageGif($im); -ImageDestroy($im); -?&gt; +<![CDATA[ +<?php +Header ("Content-type: image/gif"); +$im = imagecreate (400, 30); +$black = ImageColorAllocate ($im, 0, 0, 0); +$white = ImageColorAllocate ($im, 255, 255, 255); +ImageTTFText ($im, 20, 0, 10, 20, $white, "/path/arial.ttf", + "Testing... Omega: &#937;"); +ImageGif ($im); +ImageDestroy ($im); +?> +]]> </programlisting> </example> </para> @@ -2793,6 +3192,37 @@ </refsect1> </refentry> + <refentry id='function.imagefttext'> + <refnamediv> + <refname>ImageFtText</refname> + <refpurpose> + FreeType 2によるフォントを用いてイメージにテキストを描画する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>imagefttext</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + <paramdef>int <parameter>angle</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + <paramdef>string <parameter>font_file</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + <paramdef>array + <parameter><optional>extrainfo</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.imagetypes"> <refnamediv> <refname>ImageTypes</refname> @@ -2811,22 +3241,102 @@ <para> この関数は、PHPにリンクされているGDのバージョンでサポートされてい るイメージの形式に対応するビットフィールドを返します。次のビッ - トが返されます。IMG_GIF | IMG_JPG | IMG_PNG | IMG_WBMP - 例えば、PNGのサポートを確認するには、次のようにします。 + トが返されます。<literal>IMG_GIF</literal> | + <literal>IMG_JPG</literal> | <literal>IMG_PNG</literal> | + <literal>IMG_WBMP</literal> 例えば、PNGのサポートを確認するには、 + 次のようにします。 <example> <title>ImageTypes</title> <programlisting role="php"> -&lt;?php -if(ImageTypes() &amp; IMG_PNG) { +<![CDATA[ +<?php +if(ImageTypes() & IMG_PNG) { echo "PNG サポートが有効です"; } - ?&gt; +?> +]]> </programlisting> </example> </para> </refsect1> </refentry> + <refentry id="function.jpeg2wbmp"> + <refnamediv> + <refname>JPEG2WBMP</refname> + <refpurpose> + JPEGイメージファイルからWBMPイメージファイルに変換する + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>jpeg2wbmp</function></funcdef> + <paramdef>string <parameter>jpegname</parameter></paramdef> + <paramdef>string <parameter>wbmpname</parameter></paramdef> + <paramdef>int <parameter>d_height</parameter></paramdef> + <paramdef>int <parameter>d_width</parameter></paramdef> + <paramdef>int <parameter>threshold</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>jpegname</parameter> JPEGファイルからWBMPフォーマット + に変換し、<parameter>wbmpname</parameter>として保存します。 + <parameter>d_height</parameter>と<parameter>d_width</parameter>を + 指定すると、出力イメージの高さと幅を指定します。 + </para> + <para> + <note> + <para> + WBMPサポートは、GD-1.8以降でコンパイルしたPHPでのみ利用可能です。 + </para> + </note> + </para> + <para> + <function>png2wbmp</function>も参照下さい。 + </para> + </refsect1> + </refentry> + + <refentry id="function.png2wbmp"> + <refnamediv> + <refname>PNG2WBMP</refname> + <refpurpose> + PNGイメージファイルからWBMPイメージファイルに変換する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>png2wbmp</function></funcdef> + <paramdef>string <parameter>pngname</parameter></paramdef> + <paramdef>string <parameter>wbmpname</parameter></paramdef> + <paramdef>int <parameter>d_height</parameter></paramdef> + <paramdef>int <parameter>d_width</parameter></paramdef> + <paramdef>int <parameter>threshold</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>pngname</parameter> PNGファイルからWBMPフォーマット + に変換し、<parameter>wbmpname</parameter>として保存します。 + <parameter>d_height</parameter>と<parameter>d_width</parameter>を + 指定すると、出力イメージの高さと幅を指定します。 + </para> + <para> + <note> + <para> + WBMPサポートは、GD-1.8以降でコンパイルしたPHPでのみ利用可能です。 + </para> + </note> + </para> + <para> + <function>jpeg2wbmp</function>も参照下さい。 + </para> + </refsect1> + </refentry> + <refentry id="function.read-exif-data"> <refnamediv> <refname>read_exif_data</refname> @@ -2851,14 +3361,15 @@ <example> <title>read_exif_data</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $exif = read_exif_data ('p0001807.jpg'); while(list($k,$v)=each($exif)) { - echo "$k: $v&lt;br>\n"; + echo "$k: $v<br>\n"; } ?> -出力: +Output: FileName: p0001807.jpg FileDateTime: 929353056 FileSize: 378599 @@ -2879,6 +3390,7 @@ RawFocusDistance: 16.659999847412 Orientation: 1 ExifVersion: 0200 +]]> </programlisting> </example> </para> @@ -2892,6 +3404,31 @@ この関数は、GDイメージライブラリを必要としません。 </simpara> </note> + </para> + </refsect1> + </refentry> + + <refentry id='function.iptcembed'> + <refnamediv> + <refname>iptcembed</refname> + <refpurpose> + バイナリIPTCデータをJPEGイメージに埋めこむ + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>iptcembed</function></funcdef> + <paramdef>string <parameter>iptcdata</parameter></paramdef> + <paramdef>string <parameter>jpeg_file_name</parameter></paramdef> + <paramdef>int + <parameter><optional>spool</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry>