unicode_encode

(No version information available, might be only in CVS)

unicode_encode — unicode 文字列を任意のエンコーディングに変換する

説明

string unicode_encode ( unicode $input , string $encoding [, int $errmode ] )

unicode 文字列を受け取り、それを指定したエンコーディング encoding の文字列に変換します。

パラメータ

input: エンコードする unicode 文字列。
encoding: input の新しいエンコーディング。
errmode: 変換エラーモード。このパラメータで、コンバータが文字を変換できなかったときの動作を指定します。使用できるモードについては unicode_set_error_mode() を参照ください。このパラメータを省略した場合は、グローバルなエラーモードを使用します。

返り値

成功した場合に文字列、失敗した場合に FALSE を返します。

エラー / 例外

指定したエンコーディングの変換器が作成できない場合に E_WARNING レベルのエラーが発生します。

例

例1 unicode_encode() の例

注意: 出力は、エンティティではなく文字になります。


<?php
header ('Content-Type: text/plain; charset=ISO-8859-2');

$encoded = unicode_encode ('\u0150\u0179', 'ISO-8859-2');

echo 'Unicode semantics: ', ini_get ('unicode_semantics'), PHP_EOL;
echo 'The string itself:', $encoded, PHP_EOL;
echo 'The length of the string: ', strlen ($encoded);
?>

上の例の出力は、たとえば以下のようになります。

Unicode semantics: 1
The string itself: &#336;&#377;
The length of the string: 2

注意

警告

この関数は、 実験的 なものです。この関数の動作・名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。この関数は自己責任で使用してください。

参考

unicode_set_error_mode()
unicode_semantics()
unicode_decode()