mb_substitute_character
(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_substitute_character — 設定/獲取替代字元
說明
當輸入字元的編碼是無效的,或者字元程式碼不存在於輸出的字元編碼中時,可以為其指定一個替代字元。
無效字元可以被替換為 null
(不輸出)、string 或者 integer 值(Unicode 字元程式碼的值)。
該設定會影響 mb_convert_encoding()、 mb_convert_variables()、 mb_output_handler() 和 mb_send_mail()。
參數
-
substchar
-
指定 Unicode 值為一個 integer,或者是以下字串中的一個:
-
"none"
::不輸出 -
"long"
:輸出字元程式碼的值(比如:U+3000
、JIS+7E7E
) -
"entity"
:輸出字元的實體(比如:Ȁ
)
-
返回值
如果設定了 substchar
,在成功時返回 true
,失敗時返回 false
。
如果沒有設定 substchar
,它將返回目前設定。
範例
示例 #1 mb_substitute_character() 例子
<?php
/* 設定為 Unicode U+3013 (GETA MARK) */
mb_substitute_character(0x3013);
/* 設定十六進制格式 */
mb_substitute_character("long");
/* 顯示目前設定 */
echo mb_substitute_character();
?>