OSDN Git Service

BugTrack/2420 AutoTicketLink - Improve regex and JSON encode
[pukiwiki/pukiwiki.git] / lib / mbstring.php
index 3ae4a50..bc57e33 100644 (file)
@@ -1,20 +1,22 @@
 <?php
-/////////////////////////////////////////////////
 // PukiWiki - Yet another WikiWikiWeb clone.
+// $Id: mbstring.php,v 1.4 2005/04/29 11:24:20 henoheno Exp $
+// Copyright (C) 2003-2005 PukiWiki Developers Team
+// License: GPL v2 or (at your option) any later version
 //
-// $Id: mbstring.php,v 1.2 2004/10/13 14:46:59 henoheno Exp $
-//
+// mbstring-extension alternate functions
+// (will work with LANG == 'ja' and EUC-JP environment only)
 
 /*
- * mbstring extension ¤¬¥µ¡¼¥Ð¡¼Â¦¤Ë¸ºß¤·¤Ê¤¤»þ¤ÎÂåÂشؿô
+ * mbstring extension がサーバー側に存在しない時の代替関数
  *
- * Ãí°Õ»ö¹à
+ * 注意事項
  *
- * 1. ¼ÂºÝ¤Ë´Á»ú¥³¡¼¥ÉÊÑ´¹¤ò¹Ô¤ï¤»¤ë¤¿¤á¤Ë¤Ï¡¢ÊÌÅÓ jcode.php
- *    (TOMOºî)¤ò¥¤¥ó¥¹¥È¡¼¥ë¤¹¤ëɬÍפ¬¤¢¤ê¤Þ¤¹¡£
+ * 1. 実際に漢字コード変換を行わせるためには、別途 jcode.php
+ *    (TOMO作)をインストールする必要があります。
  *
- *   http://www.spencernetwork.org/jcode/ ¤è¤êjcode¤òÆþ¼ê¤·¡¢
- *   °Ê²¼¤ÎÍͤËŸ³«¤·¤Æ¤¯¤À¤µ¤¤¡£
+ *   http://www.spencernetwork.org/jcode/ よりjcodeを入手し、
+ *   以下の様に展開してください。
  *
  *   -+--- mbstring.php          -r--
  *    +-+- jcode_1.34/           dr-x
  *      +--- code_table.ucs2jis  -r--
  *      +--- code_table.jis2ucs  -r--
  *
- * 2. EUC-JPÀìÍѤǤ¹¡£(½ÐÎϤµ¤ì¤ë¥Ç¡¼¥¿¤¬EUC-JP¤Ç¤¢¤ëɬÍפ¬¤¢¤ê¤Þ¤¹)
+ * 2. EUC-JP専用です。(出力されるデータがEUC-JPである必要があります)
  *
  */
 
-// jcode¤Î½êºß
+// jcodeの所在
 define('JCODE_DIR', './jcode_1.34/');
 define('JCODE_FILE', JCODE_DIR . 'jcode_wrapper.php');
 
@@ -36,7 +38,7 @@ if (is_readable(JCODE_FILE)) {
        require_once(JCODE_FILE);
 }
 
-// jcode¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¡¢¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»ú¤ä´Á»ú¥³¡¼¥É¤ò°·¤¨¤Ê¤¤
+// jcodeが存在しない場合、マルチバイト文字や漢字コードを扱えない
 if (! function_exists('jcode_convert_encoding')) {
 
 //     die_message('Multibyte functions cannot be used. Please read "mbstring.php" for an additional installation procedure of "jcode".');
@@ -62,11 +64,11 @@ if (! function_exists('jcode_convert_encoding')) {
        }
 }
 
-// mb_convert_encoding -- Ê¸»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¤òÊÑ´¹¤¹¤ë
+// mb_convert_encoding -- 文字エンコーディングを変換する
 function mb_convert_encoding($str, $to_encoding, $from_encoding = '')
 {
-       // ³ÈÄ¥: ÇÛÎó¤ò¼õ¤±¤é¤ì¤ë¤è¤¦¤Ë
-       // mb_convert_variableÂкö
+       // 拡張: 配列を受けられるように
+       // mb_convert_variable対策
        if (is_array($str)) {
                foreach ($str as $key=>$value) {
                        $str[$key] = mb_convert_encoding($value, $to_encoding, $from_encoding);
@@ -76,11 +78,11 @@ function mb_convert_encoding($str, $to_encoding, $from_encoding = '')
        return jcode_convert_encoding($str, $to_encoding, $from_encoding);
 }
 
-// mb_convert_variables -- ÊÑ¿ô¤Îʸ»ú¥³¡¼¥É¤òÊÑ´¹¤¹¤ë
+// mb_convert_variables -- 変数の文字コードを変換する
 function mb_convert_variables($to_encoding, $from_encoding, &$vars)
 {
-       // Ãí: ²ÄÊÑĹ°ú¿ô¤Ç¤Ï¤Ê¤¤¡£init.php¤«¤é¸Æ¤Ð¤ì¤ë1°ú¿ô¤Î¥Ñ¥¿¡¼¥ó¤Î¤ß¤ò¥µ¥Ý¡¼¥È
-       // ÀµÄ¾¤Ë¼ÂÁõ¤¹¤ë¤Ê¤é¡¢²ÄÊÑ°ú¿ô¤ò¥ê¥Õ¥¡¥ì¥ó¥¹¤Ç¼õ¤±¤ëÊýË¡¤¬É¬Í×
+       // 注: 可変長引数ではない。init.phpから呼ばれる1引数のパターンのみをサポート
+       // 正直に実装するなら、可変引数をリファレンスで受ける方法が必要
        if (is_array($from_encoding) || $from_encoding == '' || $from_encoding == 'auto')
                $from_encoding = mb_detect_encoding(join_array(' ', $vars));
 
@@ -90,7 +92,7 @@ function mb_convert_variables($to_encoding, $from_encoding, &$vars)
        return $from_encoding;
 }
 
-// Êä½õ´Ø¿ô:ÇÛÎó¤òºÆµ¢Åª¤Ëjoin¤¹¤ë
+// 補助関数:配列を再帰的にjoinする
 function join_array($glue, $pieces)
 {
        $arr = array();
@@ -100,51 +102,51 @@ function join_array($glue, $pieces)
        return join($glue, $arr);
 }
 
-// mb_detect_encoding -- Ê¸»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¤ò¸¡½Ð¤¹¤ë
+// mb_detect_encoding -- 文字エンコーディングを検出する
 function mb_detect_encoding($str, $encoding_list = '')
 {
        static $codes = array(0=>'ASCII', 1=>'EUC-JP', 2=>'SJIS', 3=>'JIS', 4=>'UTF-8');
 
-       // Ãí: $encoding_list¤Ï»ÈÍѤ·¤Ê¤¤¡£
+       // 注: $encoding_listは使用しない。
        $code = AutoDetect($str);
        if (! isset($codes[$code])) $code = 0; // oh ;(
 
        return $codes[$code];
 }
 
-// mb_detect_order --  Ê¸»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¸¡½Ð½ç½ø¤ÎÀßÄê/¼èÆÀ
+// mb_detect_order --  文字エンコーディング検出順序の設定/取得
 function mb_detect_order($encoding_list = NULL)
 {
        static $list = array();
 
-       // Ãí: Â¾¤Î´Ø¿ô¤Ë±Æ¶Á¤òµÚ¤Ü¤µ¤Ê¤¤¡£¸Æ¤ó¤Ç¤â̵°ÕÌ£¡£
+       // 注: 他の関数に影響を及ぼさない。呼んでも無意味。
        if ($encoding_list === NULL) return $list;
 
        $list = is_array($encoding_list) ? $encoding_list : explode(',', $encoding_list);
        return TRUE;
 }
 
-// mb_encode_mimeheader -- MIME¥Ø¥Ã¥À¤Îʸ»úÎó¤ò¥¨¥ó¥³¡¼¥É¤¹¤ë
+// mb_encode_mimeheader -- MIMEヘッダの文字列をエンコードする
 function mb_encode_mimeheader($str, $charset = 'ISO-2022-JP', $transfer_encoding = 'B', $linefeed = "\r\n")
 {
-       // Ãí: $transfer_encoding¤Ë´Ø¤ï¤é¤ºbase64¥¨¥ó¥³¡¼¥É¤òÊÖ¤¹
+       // 注: $transfer_encodingに関わらずbase64エンコードを返す
        $str = mb_convert_encoding($str, $charset, 'auto');
        return '=?' . $charset . '?B?' . $str;
 }
 
-// mb_http_output -- HTTP½ÐÎÏʸ»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¤ÎÀßÄê/¼èÆÀ
+// mb_http_output -- HTTP出力文字エンコーディングの設定/取得
 function mb_http_output($encoding = '')
 {
-       return SOURCE_ENCODING; // Ãí: ²¿¤â¤·¤Ê¤¤
+       return SOURCE_ENCODING; // 注: 何もしない
 }
 
-// mb_internal_encoding --  ÆâÉôʸ»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¤ÎÀßÄê/¼èÆÀ
+// mb_internal_encoding --  内部文字エンコーディングの設定/取得
 function mb_internal_encoding($encoding = '')
 {
-       return SOURCE_ENCODING; // Ãí: ²¿¤â¤·¤Ê¤¤
+       return SOURCE_ENCODING; // 注: 何もしない
 }
 
-// mb_language --  ¥«¥ì¥ó¥È¤Î¸À¸ì¤òÀßÄê/¼èÆÀ
+// mb_language --  カレントの言語を設定/取得
 function mb_language($language = NULL)
 {
        static $mb_language = FALSE;
@@ -152,15 +154,15 @@ function mb_language($language = NULL)
        if ($language === NULL) return $mb_language;
        $mb_language = $language;
 
-       return TRUE; // Ãí: ¾ï¤ËTRUE¤òÊÖ¤¹
+       return TRUE; // 注: 常にTRUEを返す
 }
 
-// mb_strimwidth -- »ØÄꤷ¤¿Éý¤Çʸ»úÎó¤ò´Ý¤á¤ë
+// mb_strimwidth -- 指定した幅で文字列を丸める
 function mb_strimwidth($str, $start, $width, $trimmarker = '', $encoding = '')
 {
        if ($start == 0 && $width <= strlen($str)) return $str;
 
-       // Ãí: EUC-JPÀìÍÑ, $encoding¤ò»ÈÍѤ·¤Ê¤¤
+       // 注: EUC-JP専用, $encodingを使用しない
        $chars = unpack('C*', $str);
        $substr = '';
 
@@ -186,17 +188,17 @@ function mb_strimwidth($str, $start, $width, $trimmarker = '', $encoding = '')
        return $substr;
 }
 
-// mb_strlen -- Ê¸»úÎó¤ÎŤµ¤òÆÀ¤ë
+// mb_strlen -- 文字列の長さを得る
 function mb_strlen($str, $encoding = '')
 {
-       // Ãí: EUC-JPÀìÍÑ, $encoding¤ò»ÈÍѤ·¤Ê¤¤
+       // 注: EUC-JP専用, $encodingを使用しない
        return jstrlen($str);
 }
 
-// mb_substr -- Ê¸»úÎó¤Î°ìÉô¤òÆÀ¤ë
+// mb_substr -- 文字列の一部を得る
 function mb_substr($str, $start, $length = NULL, $encoding = '')
 {
-       // Ãí: EUC-JPÀìÍÑ, $encoding¤ò»ÈÍѤ·¤Ê¤¤
+       // 注: EUC-JP専用, $encodingを使用しない
        return jsubstr($str, $start, ($length === NULL) ? jstrlen($str) : $length);
 }
 ?>