= 4.0.5, PHP 5, PHP 7, PHP 8)iconv — 字符串按要求的字符編碼來轉(zhuǎn)換說明iconv(string $in_charset, string $out_charset, string $str): string將字符串 str 從 in_cha">
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
iconv — 字符串按要求的字符編碼來轉(zhuǎn)換
$in_charset
, string $out_charset
, string $str
): string
將字符串 str
從 in_charset
轉(zhuǎn)換編碼到 out_charset
。
in_charset
輸入的字符集。
out_charset
輸出的字符集。
如果你在 out_charset
后添加了字符串 //TRANSLIT
,將啟用轉(zhuǎn)寫(transliteration)功能。這個(gè)意思是,當(dāng)一個(gè)字符不能被目標(biāo)字符集所表示時(shí),它可以通過一個(gè)或多個(gè)形似的字符來近似表達(dá)。
如果你添加了字符串 //IGNORE
,不能以目標(biāo)字符集表達(dá)的字符將被默默丟棄。
否則,會(huì)導(dǎo)致一個(gè) E_NOTICE
并返回 false
。
//TRANSLIT
運(yùn)行細(xì)節(jié)高度依賴于系統(tǒng)的 iconv() 實(shí)現(xiàn)(參見 ICONV_IMPL
)。
據(jù)悉,某些系統(tǒng)上的實(shí)現(xiàn)會(huì)直接忽略 //TRANSLIT
,所以轉(zhuǎn)換也有可能失敗,out_charset
會(huì)是不合格的。
str
要轉(zhuǎn)換的字符串。
返回轉(zhuǎn)換后的字符串, 或者在失敗時(shí)返回 false
。
版本 | 說明 |
---|---|
5.4.0 |
這個(gè)版本起,字符非法時(shí)候會(huì)返回 false ,除非在輸出字符里指定了 //IGNORE 。
在之前版本,它會(huì)返回一部分字符串。
|
示例 #1 iconv() 例子
<?php
$text = "This is the Euro symbol '€'.";
echo 'Original : ', $text, PHP_EOL;
echo 'TRANSLIT : ', iconv("UTF-8", "ISO-8859-1//TRANSLIT", $text), PHP_EOL;
echo 'IGNORE : ', iconv("UTF-8", "ISO-8859-1//IGNORE", $text), PHP_EOL;
echo 'Plain : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;
?>
以上例程的輸出類似于:
Original : This is the Euro symbol '€'. TRANSLIT : This is the Euro symbol 'EUR'. IGNORE : This is the Euro symbol ''. Plain : Notice: iconv(): Detected an illegal character in input string in .\iconv-example.php on line 7