cvs: phpdoc-ja /reference/mbstring reference.xml

takagi Sun Sep 17 22:41:37 2006 UTC Modified files: /phpdoc-ja/reference/mbstring reference.xml Log: - translation updated. - WS fix.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mbstring/reference.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-ja/reference/mbstring/reference.xml diff -u phpdoc-ja/reference/mbstring/reference.xml:1.12 phpdoc-ja/reference/mbstring/reference.xml:1.13 --- phpdoc-ja/reference/mbstring/reference.xml:1.12 Fri Apr 28 09:00:26 2006 +++ phpdoc-ja/reference/mbstring/reference.xml Sun Sep 17 22:41:37 2006 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <!-- EN-Revision: 1.24 Maintainer: hirokawa Status: ready --> <!-- Purpose: international --> <!-- Membership: bundled --> <reference id="ref.mbstring"> - <title>マルチバイト文字列関数(mbstring)</title> + <title>マルチバイト文字列関数 (mbstring)</title> <titleabbrev>マルチバイト文字列</titleabbrev> <partintro> @@ -18,15 +18,15 @@ 2 種類の値しか保持できません。そのため、単一のバイトで表すことのできる値は 256 (2 の 8 乗) 種類までとなります)。 マルチバイト文字のエンコーディング法は、 - 256を越える文字を通常のビット単位の符号化システムで表現するために開発されました。 + 256 を越える文字を通常のビット単位の符号化システムで表現するために開発されました。 </para> <para> マルチバイトエンコーディングで符号化された文字列を (trim, split, splice などで) - 処理する際、こうしたエンコーディングでは二つ以上の連続するバイトが一つの文字を表す - 可能性があるため、特別な関数を使用する必要があります。 - マルチバイトに対応しない文字列関数を文字列に適用した場合、マルチバイト文字の - 先頭バイトまたは終了バイトを検出できずに文字列を壊し、多くの場合には元の意味を - 失わせてしまう可能性があります。 + 処理する際、こうしたエンコーディングでは二つ以上の連続するバイトが + 一つの文字を表す可能性があるため、特別な関数を使用する必要があります。 + マルチバイトに対応しない文字列関数を文字列に適用した場合、 + マルチバイト文字の先頭バイトまたは終了バイトを検出できずに文字列を壊し、 + 多くの場合には元の意味を失わせてしまう可能性があります。 </para> <para> <literal>mbstring</literal> はマルチバイト対応の文字列関数を提供し、 @@ -39,9 +39,9 @@ </para> <section id="mbstring.php4.req"> - <title>PHPの文字エンコーディングに関する要件</title> + <title>PHP の文字エンコーディングに関する要件</title> <para> - 以下の型のエンコーディングが、PHPで安全に使用することができます。 + 以下の型のエンコーディングが、PHP で安全に使用することができます。 <itemizedlist> <listitem> <para> @@ -49,8 +49,8 @@ <itemizedlist> <listitem> <simpara> - <literal>00h</literal>から <literal>7fh</literal>の範囲の文字に関して、 - ASCII互換(ISO646互換)のマッピングを有する。 + <literal>00h</literal> から <literal>7fh</literal> の範囲の文字に関して、 + ASCII 互換 (ISO646 互換) のマッピングを有する。 </simpara> </listitem> </itemizedlist> @@ -62,20 +62,20 @@ <itemizedlist> <listitem> <simpara> - <literal>00h</literal>から <literal>7fh</literal>の範囲の文字では、 - ASCII互換のマッピングを有する。 + <literal>00h</literal> から <literal>7fh</literal> の範囲の文字では、 + ASCII 互換のマッピングを有する。 </simpara> </listitem> <listitem> <simpara> - ISO2022エスケープシーケンスを使用しない。 + ISO2022 エスケープシーケンスを使用しない。 </simpara> </listitem> <listitem> <simpara> 単一の文字を表す複数バイトのいずれにおいても - <literal>00h</literal>から<literal>7fh</literal>の - 値を使用しない。 + <literal>00h</literal> から <literal>7fh</literal> + の値を使用しない。 </simpara> </listitem> </itemizedlist> @@ -84,7 +84,7 @@ </itemizedlist> </para> <para> - PHPで動作しないと思われる文字エンコーディングの例を以下に示します。 + PHP で動作しないと思われる文字エンコーディングの例を以下に示します。 <informalexample> <programlisting> <![CDATA[ @@ -94,12 +94,11 @@ </informalexample> </para> <para> - これらのエンコーディングで書かれたPHPスクリプトは、 + これらのエンコーディングで書かれた PHP スクリプトは、 特に符号化された文字列がスクリプトで記述子やリテラルに使用される場合には、 - 動作しない可能性がありますが、入力されるHTTPクエリに関して - <literal>mbstring</literal>の透過的なエンコーディングフィルタを - 設定することでこれらのエンコーディングをほとんど使用しないようにすることが - できます。 + 動作しない可能性がありますが、入力される HTTP クエリに関して + <literal>mbstring</literal> の透過的なエンコーディングフィルタを + 設定することでこれらのエンコーディングをほとんど使用しないようにすることができます。 </para> <note> <para> @@ -114,9 +113,9 @@ の内部エンコーディングについて同じ文字エンコーディングを使用することを推奨します。 </para> <para> - PostgreSQLを使用している場合、バックエンドの文字エンコーディング - と異なる文字エンコーディングを使用することが可能です。詳細につい - ては、PostgreSQLのマニュアルを参照ください。 + PostgreSQL を使用している場合、 + バックエンドの文字エンコーディングと異なる文字エンコーディングを使用することが可能です。 + 詳細については、PostgreSQL のマニュアルを参照ください。 </para> </note> </section> @@ -134,31 +133,30 @@ &reference.mbstring.constants; <section id="mbstring.http"> - <title>HTTP入出力</title> + <title>HTTP 入出力</title> <para> HTTP 入出力の文字エンコーディング変換はバイナリデータも変換して - しまいます。HTTP入出力にバイナリデータが使用される場合、ユーザは、 + しまいます。HTTP 入出力にバイナリデータが使用される場合、ユーザは、 文字エンコーディング変換を制御する必要があります。 </para> <note> <para> - PHP 4.3.2およびそれ以前のバージョンの場合、 - HTMLフォームの<literal>enctype</literal>が - <literal>multipart/form-data</literal>に設定された場合、 - <literal>mbstring</literal> は、POSTデータの文字エンコーディング - を変換しません。この場合、文字列を内部文字エンコーディングに変換 - してやる必要があります。 + PHP 4.3.2 およびそれ以前のバージョンの場合、 + HTML フォームの<literal>enctype</literal> が + <literal>multipart/form-data</literal> に設定された場合、 + <literal>mbstring</literal> は、POST データの文字エンコーディングを変換しません。 + この場合、文字列を内部文字エンコーディングに変換してやる必要があります。 </para> </note> <note> <para> - PHP 4.3.3以降、HTMLフォームの<literal>enctype</literal>が - <literal>multipart/form-data</literal>に設定され、かつ、 - &php.ini;において - <literal>mbstring.encoding_translation</literal>にOnが指定されて - いる場合、 - POSTデータの変数とアップロードされたファイルの名前の - 文字エンコーディングは、内部文字エンコーディングに変換されます。 + PHP 4.3.3 以降、HTML フォームの <literal>enctype</literal> が + <literal>multipart/form-data</literal> に設定され、かつ、 + &php.ini; において + <literal>mbstring.encoding_translation</literal> に On + が指定されている場合、 + POST データの変数とアップロードされたファイルの名前の文字エンコーディングは、 + 内部文字エンコーディングに変換されます。 ただし、クエリキーに関しては、変換されません。 </para> </note> @@ -166,48 +164,48 @@ <itemizedlist> <listitem> <simpara> - HTTP入力 + HTTP 入力 </simpara> <para> - PHPスクリプトでHTTP入力文字変換を制御する手段はありません。 - HTTP入力文字変換を無効にするには、&php.ini; + PHP スクリプトで HTTP 入力文字変換を制御する手段はありません。 + HTTP 入力文字変換を無効にするには、&php.ini; で行う必要があります。 <example> - <title>&php.ini;でHTTP入力変換を無効にする</title> + <title>&php.ini; で HTTP 入力変換を無効にする</title> <programlisting role="php"> <![CDATA[ -;; HTTP入力変換を無効にする +;; HTTP 入力変換を無効にする mbstring.http_input = pass -;; HTTP入力変換を無効にする (PHP 4.3.0以降) +;; HTTP 入力変換を無効にする (PHP 4.3.0 以降) mbstring.encoding_translation = Off ]]> </programlisting> </example> </para> <para> - PHPをApacheモジュールで使用する場合、PHP iniの設定を + PHP を Apache モジュールで使用する場合、&php.ini; の設定を &httpd.conf; により仮想ホスト単位で、または &htaccess; によりディレクトリ単位で上書きすることが可能です。 詳細は、<link linkend="configuration">設定</link>の節および - Apacheマニュアルを参照ください。 + Apache マニュアルを参照ください。 </para> </listitem> <listitem> <simpara> - HTTP出力 + HTTP 出力 </simpara> <para> 出力の文字エンコーディング変換を有効にする方法は複数あります。 - 一つ目は &php.ini;、もう１つは + まず &php.ini;、もうひとつは <function>ob_start</function> で <literal>ob_start</literal> のコールバック関数として <function>mb_output_handler</function> を指定するものです。 </para> <note> <para> - PHP3-i18nのユーザにとっては、<literal>mbstring</literal>の出 - 力変換は、PHP3-i18nとは異なっています。文字エンコーディング - は、出力のバッファリング機能を使用して変換されます。 + PHP3-i18n のユーザにとっては、<literal>mbstring</literal> + の出力変換は、PHP3-i18n とは異なっています。文字エンコーディングは、 + 出力のバッファリング機能を使用して変換されます。 </para> </note> </listitem> @@ -218,12 +216,12 @@ <title>&php.ini; の設定例</title> <programlisting> <![CDATA[ -;; 全てのPHPページで出力の文字エンコーディング変換を有効にする +;; 全ての PHP ページで出力の文字エンコーディング変換を有効にする ;; 出力バッファリングを有効にする output_buffering = On -;; mb_output_handlerによる出力変換を有効にする +;; mb_output_handler による出力変換を有効にする output_handler = mb_output_handler ]]> </programlisting> @@ -255,14 +253,13 @@ <section id="mbstring.supported-encodings"> <title>サポートされる文字エンコーディング</title> <simpara> - 現在、以下の文字エンコーディングが<literal>mbstring</literal>モ - ジュールによりサポートされています。文字エンコーディングは、 - <literal>mbstring</literal>関数の<literal>encoding</literal>パラ - メータで指定することが可能です。 + 現在、以下の文字エンコーディングが <literal>mbstring</literal> + モジュールによりサポートされています。文字エンコーディングは、 + <literal>mbstring</literal> 関数の <literal>encoding</literal> + パラメータで指定することが可能です。 </simpara> <para> - 以下の文字エンコーディングがこのPHPエクステンションでサポートされ - ています。 + 以下の文字エンコーディングがこの PHP 拡張モジュールでサポートされています。 </para> <itemizedlist> <listitem><simpara>UCS-4</simpara></listitem> @@ -377,7 +374,7 @@ <tgroup cols="3"> <thead> <row> - <entry>mbstring.func_overloadの値</entry> + <entry>mbstring.func_overload の値</entry> <entry>元の関数</entry> <entry>オーバーロードする関数</entry> </row> @@ -440,7 +437,7 @@ <note> <para> ディレクトリ単位の設定でこのオプションを使用することは推奨されません。 - これは、実用的な環境ではまだ安定性が確認されておらず、 + これは、実際の運用環境ではまだ安定性が確認されておらず、 予期しない結果をもたらす可能性があるためです。 </para> </note> @@ -466,18 +463,13 @@ </listitem> <listitem> <simpara> -<!-- - マルチバイト文字は通常シングルバイト文字の2倍の幅となります。 - 広い幅の文字は「全角」、狭い幅の文字は「半角」と呼ばれます。 - 通常、「全角」文字は固定幅です。 ---> - Most Japanese multibyte characters appear twice as wide as - single-byte characters. These characters are called - &quot;zen-kaku&quot; in Japanese, which means - &quot;full width&quot;. Other, narrower, characters are called - &quot;han-kaku&quot;, which means &quot;half width&quot;. The - graphical properties of the characters, however, depends upon - the type faces used to display them. + ほとんどの日本語マルチバイト文字は、シングルバイト文字の + 2 倍の幅となります。これらの文字のことを、日本語では + &quot;全角 (zen-kaku)&quot; と呼びます。これは、 + &quot;full width&quot; という意味です。一方、幅の狭い文字のことは + &quot;半角 (han-kaku)&quot; と呼びます。これは、 + &quot;half width&quot; という意味です。しかしながら、 + 文字の見た目は、それを表示する際に使用するタイプフェイスに依存します。 </simpara> </listitem> <listitem>