cvs: phpdoc-ja /reference/strings/functions htmlspecialchars.xml

takagi Tue Feb 28 21:24:43 2006 UTC Modified files: /phpdoc-ja/reference/strings/functions htmlspecialchars.xml Log: fixed typo (thanks Ando-san). fixed whitespaces. http://cvs.php.net/viewcvs.cgi/phpdoc-ja/reference/strings/functions/htmlspecialchars.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ja/reference/strings/functions/htmlspecialchars.xml diff -u phpdoc-ja/reference/strings/functions/htmlspecialchars.xml:1.5 phpdoc-ja/reference/strings/functions/htmlspecialchars.xml:1.6 --- phpdoc-ja/reference/strings/functions/htmlspecialchars.xml:1.5 Fri Jun 24 15:04:40 2005 +++ phpdoc-ja/reference/strings/functions/htmlspecialchars.xml Tue Feb 28 21:24:43 2006 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/strings.xml, last change in rev 1.1 --> <!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> <!-- CREDITS: shimooka --> @@ -7,7 +7,7 @@ <refnamediv> <refname>htmlspecialchars</refname> <refpurpose> - 特殊文字をHTMLエンティティに変換する + 特殊文字を HTML エンティティに変換する </refpurpose> </refnamediv> <refsect1> @@ -21,27 +21,28 @@ <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> - 文字の中には HTML において特殊な意味を持つものがあり、それら - 本来の値を表示したければ HTML の表現形式に変換してやらなければ - なりません。この関数は、これらの変換を行った結果の文字列を - 返します。これは、日常的なWebプログラミングにおいて最も有用な - 変換を行います。全てのHTML文字エンティティを変換する必要 - がある場合には、代わりに<function>htmlentities</function>を使用し - てください。 + 文字の中には HTML において特殊な意味を持つものがあり、 + それらの本来の値を表示したければ + HTML の表現形式に変換してやらなければなりません。 + この関数は、これらの変換を行った結果の文字列を返します。 + これは、日常的な Web プログラミングにおいて最も有用な変換を行います。 + 全ての HTML 文字エンティティを変換する必要がある場合には、代わりに + <function>htmlentities</function> + を使用してください。 </para> <simpara> - この関数は、メッセージボードやゲストブックのようにユーザーが書き - こんだテキストにおいてHTML のマークアップ用文字を区別する必要があ - る場合に有用です。オプションの2番目の形式 + この関数は、掲示板やゲストブックなどでユーザが書きこんだテキストから + HTML のマークアップ用文字を取り除く場合に有用です。 + オプションの 2 番目の引数 <parameter>quote_style</parameter> は、 - シングルおよびダブルクオートされた文字で関数が何を行うかを指定し - ます。デフォルトのモード <constant>ENT_COMPAT</constant> - は下位互換性を有しており、ダブルクオートされた文字を変換し、 - 単純な引用のままにします。 - <constant>ENT_COMPAT</constant> が設定されている場合、シングルクオート、 - ダブルクオートは共に変換され、<constant>ENT_COMPAT</constant> - が設定されている場合、シングルクオート、 - ダブルクオートは共に変換されません。 + シングルおよびダブルクオートされた文字をどのように扱うかを指定します。 + デフォルトの <constant>ENT_COMPAT</constant> + は下位互換性のためのモードで、 + ダブルクオートは変換しますがシングルクオートは変換しません。 + <constant>ENT_QUOTES</constant> + が設定されている場合は、シングルクオートとダブルクオートが共に変換されます。 + <constant>ENT_NOQUOTES</constant> + が設定されている場合は、シングルクオートとダブルクオートは共に変換されません。 </simpara> <para> 変換対象となる文字は以下の通りです。 @@ -59,7 +60,7 @@ </listitem> <listitem> <simpara> - <constant>ENT_NOQUOTES</constant> が設定されている場合のみ、 + <constant>ENT_QUOTES</constant> が設定されている場合のみ、 '&#039;' (シングルクオート) は '&amp;#039;'になります。 </simpara> </listitem> @@ -75,7 +76,7 @@ </listitem> </itemizedlist> <example> - <title><function>htmlspecialchars</function>の例</title> + <title><function>htmlspecialchars</function> の例</title> <programlisting role="php"> <![CDATA[ <?php @@ -87,16 +88,16 @@ </example> </para> <para> - この関数は上記のあげたもの以外に関しては一切の変換を行わないことに - 注意してください。すべての変換を行うには - <function>htmlentities</function>を参照してください。オプションの - 2番目の引数は、PHP 3.0.17およびPHP 4.0.3で追加されました。 + この関数は上記のあげたもの以外に関しては一切の変換を行わないことに注意してください。 + すべての変換を行うには + <function>htmlentities</function> を参照してください。オプションの + 2 番目の引数は、PHP 3.0.17 および PHP 4.0.3 で追加されました。 </para> <para> - 3番目の引数 <parameter>charset</parameter> は、 - 変換に使用される文字セットを指定します。デフォルト - の文字セットは、ISO-8859-1です。3番目の引数のサポートは、PHP - 4.1.0で追加されました。 + 3 番目の引数 <parameter>charset</parameter> は、 + 変換に使用される文字セットを指定します。 + デフォルトの文字セットは、ISO-8859-1 です。3 番目の引数のサポートは、PHP + 4.1.0 で追加されました。 </para> &reference.strings.charsets; <para>