diff --git a/reference/misc/functions/die.xml b/reference/misc/functions/die.xml index 6221fe7e7c..4a3cfb3938 100644 --- a/reference/misc/functions/die.xml +++ b/reference/misc/functions/die.xml @@ -1,22 +1,21 @@ - + die - exit と同等 + exit &Alias; - + &reftitle.description; - - この言語構造は、exit と同等です。 - + + &info.function.alias; + exit. + - - - + exit - メッセージを出力し、現在のスクリプトを終了する + ステータスコードかメッセージを返して現在のスクリプトを終了する - + &reftitle.description; - voidexit - stringstatus - - - voidexit - intstatus + neverexit + stringintstatus0 - + スクリプトの実行を終了します。 シャットダウン関数 や オブジェクトのデストラクタ - は、exit がコールされた場合にも実行されます。 - - - exit は言語構造です。 - status を指定しない場合は括弧なしでコールできます。 - + は、exit がコールされた場合にも実行されます。 + ただし、&finally; ブロックは実行されません。 + + + 終了コード 0 は、そのタスクでプログラムが成功したことを表します。 + 他の値は、実行中に何らかのエラーが発生したことを表します。 + + + exit は特殊な関数です。 + パーサーに専用のトークンがあるため、文として使用して(つまり、括弧なしで)、 + デフォルトのステータスコードでスクリプトを終了させることができます。 + + + + グローバルな exit を無効にしたり、 + 名前空間つきの関数でシャドーイングすることはできません。 + + &reftitle.parameters; - - - - status - - - status が文字列の場合は、この関数は終了直前に - status を表示します。 - - - statusint の場合は - その値が終了ステータスとして使われ、表示はされません。終了ステータスは - 0 から 254 までの値でなければなりません。終了ステータス 255 は - PHP に予約されており、使用してはいけません。ステータス 0 は、 - プログラムを正常終了させる際に使用します。 - - - - - + + + status + + + status が文字列の場合は、 + この関数は終了直前に status を表示します。 + PHP によって返される終了コードは 0 です。 + + + statusint の場合は、 + この関数は終了直前に status を表示します。 + + + 終了コードは 0 から 254 の範囲でなければならず、 + 終了コード 255 は PHP によって予約されているため使用できません。 + + + + + + PHP 8.4.0 より前のバージョンでは、 exit は PHP の標準的な + 型の相互変換のセマンティクスに基づいておらず、 + また、strict_types 宣言も適用されませんでした。 + + + また、resourcearray を含む、int 型以外の値は + string にキャストされていました。 + PHP 8.4.0 以降は、通常の型の相互変換が適用され、無効な値に対しては + TypeError をスローします。 + + + + + &reftitle.returnvalues; - - &return.void; - + + この関数は PHP スクリプトを終了するため、値を返すことはありません。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + exit は言語構造から正式な関数になったので、 + 通常の + 型の相互変換 + に従い、 + strict_types + 宣言も適用されるようになりました。また、名前付き引数や + 可変関数 + によって呼び出すこともできるようになりました。 + + + + + &reftitle.examples; - - - <literal>exit</literal> の例 - + + <function>exit</function> の基本的な使用例 + ]]> - - - - - - <literal>exit</literal> でステータスを指定する例 - + + + + <function>exit</function> に<type>string</type>を渡す例 + ]]> - - - - - - シャットダウン関数やデストラクタが実行される例 - + + + + シャットダウン関数やデストラクタが実行される例 + ]]> - - &example.outputs; - - - - - + + &example.outputs; + + + + + + 文としての <function>exit</function> + + +]]> + + &reftitle.notes; - - ¬e.language-construct; - - - - この言語構造は、die と等価です。 - - + + + PHP 8.4.0 以降は、 exit は関数ではなく言語構造でした。 + したがって、 可変関数 や 名前付き引数 を使って関数を呼び出すことはできませんでした。 + + &reftitle.seealso; - - - register_shutdown_function - - + + register_shutdown_function + シャットダウン関数 + オブジェクトのデストラクタ + -