Error Object

class Error extends Object

エラーオブジェクトは、実行時エラーが発生したときに組み込みコードによってスローされ、またスクリプトによって明示的にスローされることもある。

Standard Properties

Message:エラーメッセージです。

What:何が例外を発生させたか。これは通常、関数の名前ですが、式のエラー（数値以外の値で数学演算子を使用した場合など）によりスローされる例外の場合は空白になります。

Extra：エラーに関連する文字列がある場合、その値。この値が空でない文字列に変換できる場合、標準エラーダイアログは、"Specifically:"の後にこの文字列を含む行を表示します。

File:エラーが発生した行、または Error オブジェクトが構築された行を含むスクリプトファイルのフルパス。

Line：エラーが発生した行番号、またはErrorオブジェクトが構築された行番号です。

Stack：Errorオブジェクトが構築された時点のコールスタックを表す文字列です。各行の書式は、次のようにすることができる：

File (Line) : [What] SourceCode`r`n: 関数Whatの呼び出しを表します。Fileと Lineは、このスタックの深さにおける現在のスクリプト行を示します。SourceCodeは、ListLinesに表示されるような、その行のソースコードの近似値です。
> What`r`n: スレッドの起動を表し、通常、その上の関数呼び出しの直接の原因となるものです。
... N more: スタックトレースが切り捨てられ、表示されていないスタック項目がN個以上あることを示します。現在、Stackプロパティは2047文字を超えることはできません。

注：標準エラーダイアログでは、Message、Extra、File、Lineが独自の値プロパティであることが必要です。

Error()

Error オブジェクトを作成します。

NewError := Error(Message , What, Extra)

エラーは、「エラータイプ」に記載されているサブクラスのいずれかに置き換えることができる。ただし、サブクラスによっては、異なるパラメータを取る場合もあります。

パラメータは上記のプロパティに直接対応しますが、__NewメソッドをオーバーライドするErrorサブクラスでは異なる場合があります。

Messageと Extraは文字列に変換されます。例外が発生し、捕捉されなかった場合は、エラーダイアログで表示されます。

What エラーの原因を示します。任意の文字列を指定できますが、負整数または実行中の関数名である必要があります。1を指定すると現在の関数、-2を指定するとその関数を呼び出した関数、といった具合です。l;スクリプトがコンパイルされたり、値が有効なスタックフレームを特定できない場合、値は単に文字列に変換され、NewError.Whatに代入されます。それ以外の場合は、特定されたスタックフレームを以下のように使用して、他のプロパティを決定します：

NewError.Whatには、関数の名前が含まれています。
NewError.Lineと NewError.Fileは、関数を呼び出した行を示します。
NewError.Stackには、指示されたスタックフレームを先頭とする部分的なスタックトレースが含まれます。

Whatパラメータを使用すると、複雑な関数がヘルパー関数を使用して作業やパラメータの検証を行い、報告されるエラー情報からはそれらの内部詳細を省くことができます。事例：

MyFunction(a, b) {
    CheckArg "a", a
    CheckArg "b", b
    ;...
    CheckArg(name, value) {
        if value < 0
            throw ValueError(name " is negative", "myfunction", value)
    }
}

try
    MyFunction(1, -1)  ; err.Lineはこの行を示します。
catch ValueError as err
    MsgBox Format("{1}:{2}.`n`nFile:`t{3}`nLine:`t{4}`nWhat:`t{5}`nStack:`n{6}"
        , type(err), err.Message, err.File, err.Line, err.What, err.Stack)

try
    SomeFunction()
catch as e
    MsgBox(type(e) " in " e.What ", which was called at line " e.Line)

SomeFunction() {
    throw Error("Fail", -1)
}

Error Types

Errorのサブクラスとして、以下のものが予め定義されています：

MemoryError: A memory allocation failed.
OSError: An internal function call to a Win32 function failed. メッセージには、オペレーティングシステムによって生成されたエラーコードと説明が含まれます。OSErrors には、エラーコードを格納するNumberプロパティが追加されています。Calling OSError(Code) where Code is numeric sets Number and Message based on the given OS-defined error code. If Code is omitted, it defaults to A_LastError. For example, OSError(5).Message returns "(5) Access is denied."
TargetError: A function failed because its target could not be found. メッセージは、ウィンドウ、コントロール、メニュー、ステータスバーなど、どのような対象であるかを示します。
TimeoutError: SendMessage timed out.
TypeError: An unexpected type of value was used as input for a function, property assignment, or some other operation. 通常、Messageは期待される型と実際の型を示し、Extraは誤った値を表す文字列を含みます。
UnsetError: An attempt was made to read the value of a variable, property or item, but there was no value.
- MemberError
  - PropertyError
  - MethodError
- UnsetItemError
ValueError: An unexpected value was used as input for a function, property assignment, or some other operation. 通常、Messageはどの期待値が破られたかを示し、Extraは誤った値を表す文字列を含みます。
- IndexError: The index parameter of an object's __Item property was invalid or out of range.
ZeroDivisionError: Division by zero was attempted in an expression or with the Mod function.

また、エラーは、ベースとなるErrorクラスを使用してスローされます。

Throw, Try, Catch, Finally, OnError

Error Object

目次

Standard Properties

Error()

Error Types

関連