bind_textdomain_codeset

DOMAIN メッセージカタログから返されるメッセージの文字エンコーディングを設定/取得する

説明

stringfalse bind_textdomain_codeset(string $domain, stringnull $codeset = null)

bind_textdomain_codeset を使用することで、 gettext やその類似の関数において返される、 domain からのメッセージの文字エンコーディングを 設定したり、取得することが可能です。

パラメータ

domain

ドメイン。

codeset

コードセット。 null を指定すると、現在設定されているエンコーディングが返されます。

戻り値

domain に現在設定されているエンコーディングを返します。 エンコーディングが設定されていない場合や、失敗した場合は false を返します。 musl 1.2.6 より前のバージョンでは、常に false を返します。

エラー / 例外

domain が空の string であるか、1024 バイトより長い場合、 ValueError がスローされます。

変更履歴

バージョン 説明
8.4.0 domain が空の string である場合、 ValueError をスローするようになりました。
8.4.0 codeset パラメータが任意になりました。 これより前のバージョンでは、常に指定しなければなりませんでした。
8.0.3 codeset は、nullable になりました。 これより前のバージョンでは、 現在設定されているエンコーディングは取得できませんでした。
8.0.0 domain が長すぎる場合、ValueError をスローするようになりました。 これより前のバージョンでは、E_WARNING が発生し、false を返していました。

注意

注意:

bind_textdomain_codeset 関数の情報はプロセス単位で管理されます。 スレッドではありません。