iconv
(PHP 4 >= 4.0.5, PHP 5, PHP 7)
iconv — 文字列を指定した文字エンコーディングに変換する
説明
iconv
( string $from_encoding
, string $to_encoding
, string $string
) : string|false
文字列 string
の文字セットを from_encoding
から to_encoding
に変換します。
パラメータ
from_encoding
入力文字セット。
to_encoding
出力文字セット。
文字列
//TRANSLIT
をto_encoding
に追加すると、翻字機能が有効になります。これは、指定された文字集合で 表せない文字を、見た目の似ている別の文字に置き換える機能です。 文字列//IGNORE
を追加すると、指定された文字集合で 表せない文字は黙って切り捨てられます。 それ以外の場合はE_NOTICE
が発生し、この関数はfalse
を返します。警告
//TRANSLIT
が機能したとしたら、 どう動くかはシステムの iconv() の実装 (ICONV_IMPL
を参照) に依存します。 実装によっては、//TRANSLIT
を無視することが知られています。 よって、to_encoding
において無効な文字に対しては、 変換処理は失敗するかもしれません。string
変換する文字列。
返り値
変換された文字列、失敗した場合に false
を返します。
例
例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