メインコンテンツまでスキップ
バージョン: 20 R7 BETA

throw

throw ( errorCode {; description} ) 

        *throw* {( *errorObj* )}
引数型説明
errorCodeInteger→エラーコードを表す倍調整数
descriptionText→エラーの説明 (テキスト)
throw {( errorObj )}
引数型説明
errorObjObject→エラー構築用のプロパティを格納するオブジェクト

このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。

説明​

throw コマンドは、エラーを作成します。エラーは即座に、あるいはカレントメソッドの終了時に (遅延モード) スローされます。

4Dコード内で例外が発生した場合、throw コマンドで明示的にエラーをスローし、独自のエラーメッセージまたはエラー番号を提示することができます。これは、例外的な状態や無効な入力を知らせるのに便利です。

throw コマンドを使用してスローされたエラーは、通常のエラーと同様に 4Dランタイムによって管理されます。つまり、ON ERR CALLコマンドによって割り込みメソッドが実装されていない場合には、標準のエラーダイアログが表示されます。

このコマンドは 3つのシンタックスをサポートしています:

throw(errorCode{; description})​

このシンタックスでは、エラーコードと説明のテキスト (任意) を指定し、エラーは即座にスローされます。
description 引数を渡さなかった場合には、次の情報が提示されます:

  • ホストアプリケーションでは: Error code {errorCode}: (host)
  • コンポーネントでは: Error code {errorCode}: (C00x)
throw(errorObj)​

errorObj オブジェクト引数を使うことで、エラー情報をより詳細に指定し、エラー処理の管理をさらに強化できます。このオブジェクト引数には以下のプロパティのほか、messageプロパティのプレースホルダーを置き換えるためのカスタムプロパティを含めることができます。

プロパティ型説明
componentSignaturetextエラーの発生源を一意に識別するための 4文字のラテン文字のシグニチャ。 componentSignature が渡されない場合、コマンドはホストデータベースには "host"、コンポ ーネントには "C001"、"C002"、...を使用します。
errCodenumberエラーコード。 errCode が渡されない場合、コマンドは -1 を使用します。
messagetextエラーの説明。
message には、errorObj オブジェクト引数に追加されたカスタムプロパティによって置き換えられるプレースホルダーを含めることができます。各プレースホルダーは、置き換えに使用するカスタムプロパティ名を中括弧 {} で囲むことで指定します。 message が渡されない場合、または空文字列の場合、コマンドはカレントデータベースの xliff ファイルを検索し、"ERR_{componentSignature}_{errCode}" に合致する resname を探します。
を探します。
deferredbooleanカレントメソッドの終了時またはTry ブロックの終了時にエラーを延期するかどうかを指定します。デフォルト値は false です。

このシンタックスを使用すると、Last errors で errorObjオブジェクトが返されます。

注記: 同じプロジェクトメソッド内でこのコマンドを複数回呼び出して、複数のエラーを生成することができます。遅延モードを使って、これらのエラーを一度にスローできます。

throw​

このシンタックスは、カレントエラーをすべて遅延モードでスローします。つまり、これらのエラーはエラースタックに追加され、カレントメソッド終了時に処理されます。これは通常、ON ERR CALL コールバック内でおこなわれます。

  • アプリケーションにおいて: 発生したエラーはエラースタックに追加され、カレントメソッド終了時にアプリケーションの ON ERR CALL メソッドが呼び出されます。Last errors 関数はエラースタックを返します。
  • コンポーネントにおいて: エラースタックはホストアプリケーションに送信され、ホストアプリケーションの ON ERR CALL メソッドが呼び出されます。

例題 1​

 var $code : Integer
 var $description : text
 $code:=50042 // カスタムコード
 $description:=“”
 throw($code ;$description) // "これはカスタムエラーです" というメッセージと errCode = 50042 でエラーをスローします

例題 2​

throw({errCode: 1; message: "これはエラーです"}) // "これはエラーです" というメッセージと errCode = 1 でエラーをスローします

例題 3​

throw({errCode: 1}) // "Error code: 1 (host)" というメッセージと errCode = 1 でエラーをスローします

例題 4​

throw({message: "これはエラーです"})  // "これはエラーです" というメッセージと errCode = -1 でエラーをスローします

例題 5​

throw({message: "これはエラーです"; deferred: True}) // "これはエラーです" というメッセージと errCode = -1 でエラーを遅延モードでスローします

例題 6​

throw({componentSignature: "xbox"; errCode: 600; name: "myFileName"; path: "myFilePath"; deferred: True})// "ファイル myFileName が見つかりません (myFilePath)" というメッセージのエラーを遅延モードでスローします

参照​

ASSERT
Last errors
ON ERR CALL