MException

入力変数名がワークスペースにない場合に例外をスローします。

str = input('Type a variable name: ','s');
if ~exist(str,'var')
    ME = MException('MyComponent:noSuchVariable', ...
        'Variable %s not found',str);
    throw(ME)
end

入力プロンプトでは、ワークスペースにない変数を入力します。たとえば、notaVariable を入力します。

Variable notaVariable not found

ワークスペースに notVariable が存在しないため、MATLAB は MException オブジェクトを作成しスローします。

関数 surf への入力なしの呼び出しを含むファイル myfile.m を作成します (この関数の呼び出しは結果的に例外となりますが、説明を分かりやすくするためにそうしています)。MATLAB がスローする例外を MException オブジェクト ME でキャッチし、ME の message プロパティにアクセスしてエラー メッセージを表示します。

try
    surf
catch ME
    disp('Error Message:')
    disp(ME.message)
end

Error Message:
Not enough input arguments.

エラー識別子を抽出します。

ME.identifier

ans =

    'MATLAB:narginchk:notEnoughInputs'

stack プロパティの内容をクエリします。この例では、呼び出しスタックは 2 行 1 列の構造体配列で表されます。

for i = 1:numel(ME.stack)
    ME.stack(i)
end

ans = 

  struct with fields:

    file: 'matlabroot\toolbox\matlab\graph3d\surf.m'
    name: 'surf'
    line: 49


ans = 

  struct with fields:

    file: 'c:\myMATLABfiles\myfile.m'
    name: 'myfile'
    line: 2

stack の最初の要素は例外が発生したときのファイル名 (surf.m)、関数名 (surf)、行数 (49) を表示します。stack の 2 番目の要素は、呼び出し元のスクリプトで例外が発生した名前と行数を示します。

存在しない関数 notaFunction を呼び出すことで生成された例外を検出します。関数が定義されていないと、警告を発行して出力に値 0 を割り当てます。

try
    a = notaFunction(5,6);
catch ME
    if strcmp(ME.identifier,'MATLAB:UndefinedFunction')
        warning('Function is undefined.  Assigning a value of 0.');
    else
        rethrow(ME)
    end
end

Warning: Function is undefined.  Assigning a value of 0. 

notaFunction への呼び出しは、それ自体がエラーになります。このコードで try と catch を使用して未定義の関数の例外を検出し、警告として再パッケージ化することで、MATLAB は引き続き後続のコマンドを実行することができます。検出された例外のエラー識別子が異なる場合、MATLAB は例外を再スローします。