XLIV. iconv 関数

導入

このモジュールには、iconv による文字集合の変換機能へのインターフェースが含まれています。 このモジュールにより、ローカルな文字集合で表された文字列を、Unicod文字集合のような 他の文字集合で表わされた文字列に変換することができます。 サポートされる文字集合は、使用するシステムのiconvの実装に依存します。 いくつかのシステムではiconv関数は意図した通りに動作しない可能性があることに注意して下さい。 この場合は、GNU libiconv ライブラリをインストール すると良いでしょう。 このライブラリの出力は、多くの場合、より妥当なものとなります。

PHP 5.0.0以降、この拡張モジュールには、 多言語スクリプトを書く際に有用な種々のユーティリティが附属しています。 この新機能については、以下のセクションを参照して下さい。

要件

使用しているシステムが、最近のPOSIX対応システムのどれかである場合には、標準C 言語ライブラリの中にiconv機能が含まれているため、何かをする必要はありません。 そうでない場合は、 libiconvライブラリを入手して使用する システムにインストールする必要があります。

インストール手順

この関数を使用するには、 PHPバイナリを以下のオプションを指定して 構築する必要があります。 --with-iconv[=DIR]

Windows® ユーザへの注意: Windows®環境でこのモジュールを有効にするには、 PHP/Win32バイナリパッケージに附属するiconv.dllまたは iconv-1.3.dll (4.2.1より前)という名前の DLLファイルを環境変数PATHで指定した ディレクトリまたは Windows® のシステムディレクトリにコピーする 必要があります。

実行用の設定

これらの関数の動作は、php.iniの設定により変化します。

表 1. iconv設定オプション

名前デフォルト変更の可否
iconv.input_encodingICONV_INPUT_ENCODINGPHP_INI_ALL
iconv.output_encodingICONV_OUTPUT_ENCODINGPHP_INI_ALL
iconv.internal_encodingICONV_INTERNAL_ENCODINGPHP_INI_ALL
PHP_INI_*定数に関する詳細と定義については、 ini_set()を参照して下さい。

リソース型

この拡張モジュールはリソース型を全く定義しません。

定義済みの定数

PHP 4.3.0以降、この拡張モジュールで使用される iconv 実装の種類を実行時に調べることができます。

表 2. iconv定数

名前説明
ICONV_IMPLstring実装の名前
ICONV_VERSIONstring実装のバージョン

注意: これらの定数を用いて実装に依存するスクリプトを書くことは全く推奨されません。

PHP 5.0.0以降、以下の定数も利用可能です。

表 3. PHP 5.0.0以降で利用可能なiconv定数

名前説明
ICONV_MIME_DECODE_STRICTintegericonv_mime_decode()で使用されるビットマスク
ICONV_MIME_DECODE_CONTINUE_ON_ERRORintegericonv_mime_decode()で使用されるビットマスク

以下も参照下さい

GNU Recode 関数も参照して下さい。

目次
iconv_get_encoding -- iconv拡張モジュールの内部設定変数を取得する
iconv_mime_decode_headers --  Decodes multiple MIME header fields at once
iconv_mime_decode --  Decodes a MIME header field
iconv_mime_encode --  Composes a MIME header field
iconv_set_encoding -- 文字エンコーディング変換用の設定を行なう
iconv_strlen --  Returns the character count of string
iconv_strpos --  Finds position of first occurrence of a needle within a haystack
iconv_strrpos --  Finds the last occurrence of a needle within the specified range of haystack
iconv_substr --  Cut out part of a string
iconv -- 文字列を指定した文字エンコーディングに変換する
ob_iconv_handler --  出力バッファハンドラとして文字エンコーディングを変換する