textdomain

デフォルトドメインを設定する

説明

string textdomain(stringnull $domain = null)

この関数は、gettext がコールされた際に検索を 行うドメインを設定します。このドメインは、通常はアプリケーション名から 付けられます。

パラメータ

domain

新しいメッセージドメイン。null を指定すると、現在の設定をそのまま 取得し、変更しません。

戻り値

成功すると、この関数はドメインを変更した後に現在のメッセージドメインを 返します。

エラー / 例外

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

domain が "0" である場合、 ValueError がスローされます。

変更履歴

バージョン 説明
8.4.0 domain が空の string または "0" である場合、 ValueError をスローするようになりました。 これより前のバージョンでは、どちらの場合も、現在のメッセージドメインを変更せずに返していました。
8.4.0 domain パラメータが任意になりました。 これより前のバージョンでは、常に指定しなければなりませんでした。
8.0.0 引数が長すぎる場合、ValueError をスローするようになりました。 これより前のバージョンでは、E_WARNING が発生し、false を返していました。

注意

注意:

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