在线文档教程
PHP

iconv

iconv

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

iconv - 将字符串转换为请求的字符编码

描述

string iconv ( string $in_charset , string $out_charset , string $str )

str来自in_charsetto 的字符串执行字符集转换out_charset

参数

in_charset

输入字符集。

out_charset

输出字符集。

如果您将字符串// TRANSLITout_charset音译被激活。这意味着当字符不能在目标字符集中表示时,它可以通过一个或几个相似的字符来近似。如果追加字符串// IGNORE,那么无法在目标字符集中表示的字符会被丢弃。否则,E_NOTICE会生成并且函数将返回FALSE

警告

如果以及如何// TRANSLIT的工作完全取决于系统的iconv()实现(参见ICONV_IMPL)。有些实现已知忽略// TRANSLIT,所以转换可能会失败,因为对于非法的字符来说,转换可能会失败out_charset

str

要转换的字符串。

返回值

返回转换后的字符串或失败时返回FALSE

Changelog

版本描述
5.4.0自此版本以来,该函数在非法字符上返回FALSE,除非在输出字符集中指定了// IGNORE。之前,它返回部分输出字符串。

示例

Example #1 iconv() example

<?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

← iconv_substr

ob_iconv_handler →