Iconv

PHP関数リファレンス

iconv 関数

導入

このモジュールには、iconv による文字集合の変換機能へのインターフェースが含まれています。 このモジュールにより、ローカルな文字集合で表された文字列を、Unicode 文字集合のような 他の文字集合で表わされた文字列に変換することができます。 サポートされる文字集合は、使用するシステムの 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 5 で PHP の一部として組み込まれました。 iconv.dll や php_iconv.dll は もはや必要ありません。

実行時設定

php.ini の設定により動作が変化します。
表 122. Iconv 設定オプション

名前	デフォルト	変更の可否	変更履歴
iconv.input_encoding	"ISO-8859-1"	PHP_INI_ALL	PHP 4.0.5 以降で使用可能です。
iconv.output_encoding	"ISO-8859-1"	PHP_INI_ALL	PHP 4.0.5 以降で使用可能です。
iconv.internal_encoding	"ISO-8859-1"	PHP_INI_ALL	PHP 4.0.5 以降で使用可能です。

PHP_INI_* 定数の詳細および定義については 付録 G. php.ini ディレクティブ を参照してください。

警告

(IBM AIX のように)いくつかのシステムでは "ISO-8859-1" ではなく "ISO8859-1" を使用することがあります。そのような場合は、設定オプションや 関数のパラメータにはこの値を使用しなければなりません。

注意: 設定オプション iconv.input_encoding は、 今のところ一切利用されていません。

リソース型

リソース型は定義されていません。

定義済み定数

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

名前	型	説明
ICONV_IMPL	string	実装の名前
ICONV_VERSION	string	実装のバージョン

注意: これらの定数を用いて実装に依存するスクリプトを書くことは全く推奨されません。
PHP 5.0.0以降、以下の定数も利用可能です。 表 124. PHP 5.0.0以降で利用可能なiconv定数

名前	型	説明
ICONV_MIME_DECODE_STRICT	integer	iconv_mime_decode()で使用されるビットマスク
ICONV_MIME_DECODE_CONTINUE_ON_ERROR	integer	iconv_mime_decode()で使用されるビットマスク

参考

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

目次

iconv_get_encoding — iconv 拡張モジュールの内部設定変数を取得する

iconv_mime_decode_headers — 複数の MIME ヘッダフィールドを一度にデコードする

iconv_mime_decode — MIME ヘッダフィールドをデコードする

iconv_mime_encode — MIME ヘッダフィールドを作成する

iconv_set_encoding — 文字エンコーディング変換用の設定を行なう

iconv_strlen — 文字列の文字数を返す

iconv_strpos — 文字列が最初に現れる場所を見つける

iconv_strrpos — 文字列が最後に現れる場所を見つける

iconv_substr — 文字列の一部を切り出す

iconv — 文字列を指定した文字エンコーディングに変換する

ob_iconv_handler — 出力バッファハンドラとして文字エンコーディングを変換する

iconv

(PHP 4 >= 4.0.5, PHP 5)
iconv — 文字列を指定した文字エンコーディングに変換する

説明

string iconv ( string in_charset, string out_charset, string str )
文字列 str の文字セットを in_charset から out_charset に変換します。

パラメータ

in_charset

入力文字セット。

out_charset

出力文字セット。
文字列 //TRANSLIT を out_charset に追加すると、翻字機能が有効になります。これは、指定された文字集合で 表せない文字を、見た目の似ている別の文字に置き換える機能です。 文字列 //IGNORE を追加すると、指定された文字集合で 表せない文字は黙って切り捨てられます。 それ以外の場合は、str の中に変換できない文字が 出現した時点で変換が打ち切られます。

str

変換する文字列。

返り値

変換された文字列、あるいは失敗した場合に FALSE を返します。

例

例 889. iconv() の例
<?php
echo iconv("ISO-8859-1", "UTF-8", "This is a test.");
?>

ウィキペディア

iconv

出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2021/07/30 06:02 UTC 版)

iconv（アイコンブ）は異なる文字コード間の相互変換を行う標準API。または、そのAPIに付属する文字コード変換ユーティリティプログラム。名前は「International Codeset Conversion Library」に由来する。GNUによる実装が有名で、変換ライブラリ libiconv のライセンスはLGPL、変換プログラム iconv のライセンスはGPLである。