[PHP-DOC] cvs: phpdoc /en/functions mbstring.xml
hirokawaSat Mar 16 07:44:07 2002 EDT Modified files: /phpdoc/en/functionsmbstring.xml Log: added note for mbstring. Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.24 phpdoc/en/functions/mbstring.xml:1.25 --- phpdoc/en/functions/mbstring.xml:1.24 Sun Mar 10 03:51:50 2002 +++ phpdoc/en/functions/mbstring.xmlSat Mar 16 07:44:06 2002 -1,5 +1,5 ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.24 $ -- +!-- $Revision: 1.25 $ -- reference id=ref.mbstring titleMulti-Byte String Functions/title titleabbrevMulti-Byte String/titleabbrev -1442,7 +1442,8 para parameterfrom-encoding/parameter is specified by character code name before conversion. it can be array or string - comma - separated enumerated list. + separated enumerated list. If it is not specified, the internal + encoding will be used. /para para example
[PHP-DOC] cvs: phpdoc /en/functions mbstring.xml
derick Sat Feb 2 10:55:09 2002 EDT Modified files: /phpdoc/en/functionsmbstring.xml Log: - Fix annoying space in TOC Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.21 phpdoc/en/functions/mbstring.xml:1.22 --- phpdoc/en/functions/mbstring.xml:1.21 Sat Feb 2 10:36:02 2002 +++ phpdoc/en/functions/mbstring.xmlSat Feb 2 10:55:09 2002 @@ -1,10 +1,8 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.21 $ -- +!-- $Revision: 1.22 $ -- reference id=ref.mbstring titleMulti-Byte String Functions/title - titleabbrev - Multi-Byte String - /titleabbrev + titleabbrevMulti-Byte String/titleabbrev partintro sect1 id=mb-intro titleIntroduction/title
[PHP-DOC] cvs: phpdoc /en/functions mbstring.xml
hirokawaSun Jan 6 22:23:06 2002 EDT Modified files: /phpdoc/en/functionsmbstring.xml Log: removed 'role=php' for code in php.ini. Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.19 phpdoc/en/functions/mbstring.xml:1.20 --- phpdoc/en/functions/mbstring.xml:1.19 Sun Jan 6 21:52:21 2002 +++ phpdoc/en/functions/mbstring.xmlSun Jan 6 22:23:06 2002 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.19 $ -- +!-- $Revision: 1.20 $ -- reference id=ref.mbstring titleMulti-Byte String Functions/title titleabbrev @@ -200,7 +200,7 @@ para example titleliteralphp.ini/literal setting example/title - programlisting role=php + programlisting ![CDATA[ ;; Enable output character encoding conversion for all PHP pages @@ -356,7 +356,7 @@ para example titleliteralphp.ini/literal setting example/title - programlisting role=php + programlisting ![CDATA[ ;; Set default internal encoding ;; Note: Make sure to use character encoding works with PHP @@ -389,7 +389,7 @@ para example titleliteralphp.ini/literal setting for literalEUC-JP/literal users/title - programlisting role=php + programlisting ![CDATA[ ;; Disable Output Buffering output_buffering = Off @@ -415,7 +415,7 @@ para example titleliteralphp.ini/literal setting for literalSJIS/literal users/title - programlisting role=php + programlisting ![CDATA[ ;; Enable Output Buffering output_buffering = On @@ -1843,7 +1843,7 @@ para example titleparameterconvmap/parameter example/title - programlisting + programlisting role=php ![CDATA[ $convmap = array ( int start_code1, int end_code1, int offset1, int mask1,
[PHP-DOC] cvs: phpdoc /en/functions mbstring.xml /ja Translators /ja/functions mbstring.xml session.xml strings.xml
hirokawaSun Oct 28 18:16:09 2001 EDT Modified files: /phpdoc/en/functionsmbstring.xml /phpdoc/ja Translators /phpdoc/ja/functionsmbstring.xml session.xml strings.xml Log: updated translation. Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.13 phpdoc/en/functions/mbstring.xml:1.14 --- phpdoc/en/functions/mbstring.xml:1.13 Wed Oct 17 12:24:00 2001 +++ phpdoc/en/functions/mbstring.xmlSun Oct 28 18:16:08 2001 @@ -1,5 +1,5 @@ ?xml encoding=iso-8859-1? -!-- $Revision: 1.13 $ -- +!-- $Revision: 1.14 $ -- reference id=ref.mbstring titleMulti-Byte String Functions/title titleabbrev @@ -457,7 +457,7 @@ para itemizedlist listitem -simparaStorage for a character can be up to four +simparaStorage for a character can be up to six bytes/simpara /listitem listitem @@ -582,7 +582,7 @@ titleDescription/title funcsynopsis funcprototype - funcdefstring + funcdefboolean functionmb_parse_str/function /funcdef paramdefstring Index: phpdoc/ja/Translators diff -u phpdoc/ja/Translators:1.28 phpdoc/ja/Translators:1.29 --- phpdoc/ja/Translators:1.28 Sun Oct 14 06:21:15 2001 +++ phpdoc/ja/Translators Sun Oct 28 18:16:08 2001 @@ -3,6 +3,7 @@ bookinfo.xml Rui Hirokawa preface.xmlRui Hirokawa --- appendices --- +appendices/commandline.xml Rui Hirokawa appendices/debugger.xmlMichihide Hotta appendices/escaping.xmlRui Hirokawa appendices/history.xml Rui Hirokawa Index: phpdoc/ja/functions/mbstring.xml diff -u phpdoc/ja/functions/mbstring.xml:1.9 phpdoc/ja/functions/mbstring.xml:1.10 --- phpdoc/ja/functions/mbstring.xml:1.9Sun Aug 12 20:33:48 2001 +++ phpdoc/ja/functions/mbstring.xmlSun Oct 28 18:16:08 2001 @@ -462,7 +462,7 @@ itemizedlist listitem simpara -1文字は最大4バイトになる +1文字は最大6バイトになる /simpara /listitem listitem @@ -583,7 +583,7 @@ title説明/title funcsynopsis funcprototype - funcdefstring + funcdefboolean functionmb_parse_str/function /funcdef paramdefstring @@ -597,7 +597,7 @@ para functionmb_parse_str/function は、GET/POST/COOKIE データをパー スし、グローバル変数を設定します。PHPは、生のPOST/COOKIEを提供し - ないため、原状ではGETデータでのみ使用可能です。この関数は、URLエ + +ないため、現状ではGETデータでのみ使用可能です。この関数は、URLエ ンコードされたデータをパース、エンコーディングを検出、内部エンコー ディングへ変換し、配列parameterresult/parameterまたはグローバ ル配列に設定します。 @@ -1661,8 +1661,8 @@ functionmb_convert_variables/function は、エンコーディング parameterfrom-encoding/parameterの変数 parametervars/parameterをエンコーディング - parameterto-encoding/parameterに変換します。成功時に変換ド前 - の文字エンコーディングを返し、失敗した場合にfalse;を返します。 + parameterto-encoding/parameterに変換します。成功時に変換前の + +文字エンコーディングを返し、失敗した場合にfalse;を返します。 /para para functionmb_convert_variables/function は、エンコーディング検 Index: phpdoc/ja/functions/session.xml diff -u phpdoc/ja/functions/session.xml:1.23 phpdoc/ja/functions/session.xml:1.24 --- phpdoc/ja/functions/session.xml:1.23Sun Aug 12 20:33:49 2001 +++ phpdoc/ja/functions/session.xml Sun Oct 28 18:16:08 2001 @@ -139,8 +139,7 @@ $count++; ?gt; -こんにちは、あなたがこのページに来たのはlt;?php echo $count; ?gt; times.lt;pgt; -回目ですね。 +こんにちは、あなたがこのページに来たのはlt;?php echo $count; +?gt;回目ですね。 lt;pgt; lt;php? # ユーザーがクッキーを使用不可としている場合は、セッションIDを Index: phpdoc/ja/functions/strings.xml diff -u phpdoc/ja/functions/strings.xml:1.44 phpdoc/ja/functions/strings.xml:1.45 --- phpdoc/ja/functions/strings.xml:1.44Sun Oct 14 09:53:20 2001 +++ phpdoc/ja/functions/strings.xml Sun Oct 28 18:16:08 2001 @@ -2409,8 +2409,7 @@ refentry id=function.strip-tags refnamediv refnamestrip_tags/refname -refpurpose文字列から Strip HTML および PHP タグを取り除く -/refpurpose +refpurpose文字列からHTMLおよびPHPタグを取り除く/refpurpose /refnamediv refsect1 title説明/title @@ -2446,7 +2445,7 @@ refentry id=function.stripcslashes refnamediv -refnameStripCSlashes/refname +refnamestripcslashes/refname refpurpose addcslashesでクォートされた文字列をアンクォートする /refpurpose @@ -2460,9 +2459,9 @@ /funcprototype /funcsynopsis para - バックスラッシュを取り除いた文字列を返します。 - C 言語と同様に literal\n/literal, literal\r/literal ..., 8進表現 - , 16進表現を認識します。 + +バックスラッシュを取り除いた文字列を返します。C言語と同様に + literal\n/literal, literal\r/literal ..., 8進表現, 16進表 + 現を認識します。 note simpara PHP4b3-dev で追加されました。 @@ -2477,7 +2476,7 @@ refentry id=function.stripslashes refnamediv -refnameStripSlashes/refname +refnamestripslashes/refname refpurpose addslashesでクォートされた文字列のクォート部分を取り除く /refpurpose
[PHP-DOC] cvs: phpdoc /en/functions mbstring.xml
hirokawaThu Jun 28 23:20:29 2001 EDT Modified files: /phpdoc/en/functionsmbstring.xml Log: fixed some typos. Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.2 phpdoc/en/functions/mbstring.xml:1.3 --- phpdoc/en/functions/mbstring.xml:1.2Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/mbstring.xmlThu Jun 28 23:20:28 2001 @@ -1,117 +1,305 @@ reference id=ref.mbstring titleMulti-Byte String Functions/title - titleabbrevMulti-Byte String/titleabbrev + titleabbrev + Multi-Byte String + /titleabbrev partintro warn.experimental; sect1 id=mb-intro titleIntroduction/title warning simpara - This module is EXPERIMENTAL. Function name/API is subject to be - changed. Current conversion filter supports Japanese only. + This module is EXPERIMENTAL. Function name/API is subject to + change. Current conversion filter supports Japanese only. /simpara /warning para - There are many languages that all characters cannot be expressed + There are many languages in which all characters can be expressed by single byte. Multi-byte character codes are used to express many characters for many languages. literalmbstring/literal is developed to handle Japanese characters. However, many literalmbstring/literal functions are able to handle - character codes other than Japanese. + character encoding other than Japanese. /para para - Multi-byte character encoding represents single character with + A multi-byte character encoding represents single character with consecutive bytes. Some character encoding has shift(escape) - sequences to start/end multi-byte character string. Therefore, + sequences to start/end multi-byte character strings. Therefore, a multi-byte character string may be destroyed when it is divided - and/or counted, unless multi-byte character encoding safe method - is used. literalmbstring/literal functions support multi-byte - character safe string functions and other utility functions such - as conversion functions. + and/or counted unless multi-byte character encoding safe method + is used. This module provides multi-byte character safe string + functions and other utility functions such as conversion + functions. /para +para + Since PHP is basically designed for ISO-8859-1, some multi-byte + character encoding does not work well with PHP. Therefore, it is + important to set literalmbstring.internal_encoding/literal to + a character encoding that works with PHP. +/para +para + PHP4 Character Encoding Requirements +/para +para + itemizedlist + listitem + simpara + Per byte encoding + /simpara + /listitem + listitem + simpara + Single byte characters in range of literal00h-7fh/literal + which is compatible with literalASCII/literal + /simpara + /listitem + listitem + simpara + Multi-byte characters without literal00h-7fh/literal + /simpara + /listitem + /itemizedlist +/para +para + These are examples of internal character encoding that works with + PHP and does NOT work with PHP. + informalexample + programlisting -sect2 id=mb-ja-basic - titleBasics for Japanese multi-byte character/title +Character encodings work with PHP: +ISO-8859-*, EUC-JP, UTF-8 + + +Character encodings do NOT work with PHP: +JIS, SJIS + /programlisting + /informalexample +/para +para + Character encoding, that does not work with PHP, may be converted + with literalmbstring/literal's HTTP input/output conversion + feature/function. +/para +note + para + SJIS should not be used for internal encoding unless the reader + is familiar with parser/compiler, character encoding and + character encoding issues. + /para +/note +note para - Most Japanese characters need more than 1 byte for a - character. In addition to this, several character encodings are - used under Japanese environment. There are EUC-JP, Shift_JIS and - ISO-2022-JP character encoding. As Unicode is getting popular, - UTF-8 is used also. To develop Web application for Japanese - environment, it is important to use these character codes depend - on its purpose, HTTP input/output, RDBMS and E-mail. + If you use database with PHP, it is recommended that you use the + same character encoding for both database and literalinternal + encoding/literal for ease of use and better performance. + /para + para + If you are using PostgreSQL, it supports character + encoding that is different from backend character encoding. See + the PostgreSQL manual for details. /para +/note + +
[PHP-DOC] cvs: phpdoc /en/functions mbstring.xml
hirokawaSun May 20 00:43:43 2001 EDT Added files: /phpdoc/en/functionsmbstring.xml Log: added mbstring.xml. Index: phpdoc/en/functions/mbstring.xml +++ phpdoc/en/functions/mbstring.xml reference id=ref.mbstring titleMulti-Byte String Functions/title titleabbrevMulti-Byte String/titleabbrev partintro sect1 id=mb-intro titleIntroduction/title warning simpara This module is EXPERIMENTAL. Function name/API is subject to be changed. Current conversion filter supports Japanese only. /simpara /warning para There are many languages that all characters cannot be expressed by single byte. Multi-byte character codes are used to express many characters for many languages. literalmbstring/literal is developed to handle Japanese characters. However, many literalmbstring/literal functions are able to handle character codes other than Japanese. /para para Multi-byte character encoding represents single character with consecutive bytes. Some character encoding has shift(escape) sequences to start/end multi-byte character string. Therefore, multi-byte character string may be destroyed when it is divided and/or counted, unless multi-byte character encoding safe method is used. literalmbstring/literal functions support multi-byte character safe string functions and other utility functions such as conversion functions. /para sect2 id=mb-ja-basic titleBasics for Japanese multi-byte character/title para Most Japanese characters need more than 1 byte for a character. In addition to this, several character encodings are used under Japanese environment. There are EUC-JP, Shift_JIS and ISO-2022-JP character encoding. As Unicode is getting popular, UTF-8 is used also. To develop Web application for Japanese environment, it is important to use these character codes depend on its purpose, HTTP input/output, RDBMS and E-mail. /para para itemizedlist listitem simpara Storage for a character can be upto four bytes /simpara /listitem listitem simpara A multi-byte character usually has twice of width compare to single byte characters. Wider character is called zen-kaku - meaning full width, narrower character called han-kaku - meaning half width. zen-kaku characters are fixed width usually. /simpara /listitem listitem simpara Some character encoding defines shift sequence for entering/exiting multi-byte character strings. /simpara /listitem listitem simpara Database may allocate storage for characters that differs from size used in PHP even if the same character encoding is used. (For example, PostgreSQL) /simpara /listitem listitem simpara E-mail is supposed to use ISO-2022-JP. /simpara /listitem listitem para quot;i-modequot; web site is supposed to use Shift_JIS. /para /listitem /itemizedlist /para /sect2 sect2 id=mb-code titleSupported character encodings/title para Following character encodings are supported in this PHP extension : literalUCS-4/literal, literalUCS-4BE/literal, literalUCS-4LE/literal, literalUCS-2/literal, literalUCS-2BE/literal, literalUCS-2LE/literal, literalUTF-32/literal, literalUTF-32BE/literal, literalUTF-32LE/literal, literalUCS-2LE/literal, literalUTF-16/literal, literalUTF-16BE/literal, literalUTF-16LE/literal, literalUTF-8/literal, literalUTF-7/literal, literalASCII/literal, literalEUC-JP/literal, literalSJIS/literal, literaleucJP-win/literal, literalSJIS-win/literal, literalISO-2022-JP/literal(literalJIS/literal), literalISO-8859-1/literal, literalISO-8859-2/literal, literalISO-8859-3/literal, literalISO-8859-4/literal, literalISO-8859-5/literal, literalISO-8859-6/literal, literalISO-8859-7/literal, literalISO-8859-8/literal, literalISO-8859-9/literal, literalISO-8859-10/literal, literalISO-8859-13/literal, literalISO-8859-14/literal, literalISO-8859-15/literal. /para /sect2 sect2 id=mb-ini title php.ini settings /title para itemizedlist listitem simpara literalmbstring.internal_encoding/literal defines default internal character encoding. /simpara /listitem listitem simpara literalmbstring.http_input/literal defines default HTTP input character encoding. /simpara /listitem listitem simpara literalmbstring.http_output/literal defines default HTTP
