コードアナライザーを使用したエラーと警告についてのコードのチェック

MATLAB^® コードアナライザーは、コードの問題についてコードを自動的にチェックできます。コードについて警告とエラーメッセージを表示し、そのメッセージに基づいてファイルを変更できます。メッセージに示された問題が修正されているかを確認できるように、メッセージは自動的かつ連続的に更新されます。メッセージによっては、追加情報と自動コード修正のいずれかまたは両方が提供されています。

MATLAB コードアナライザーによって実行されるすべてのチェックのリストは、こちらのIndex of Code Analyzer Checksにあります。

継続的なコードチェックの有効化

継続的なコードチェックを有効にするには、[ホーム] タブの [環境] セクションで [基本設定] をクリックします。[MATLAB] 、 [コードアナライザー] を選択し、[統合された警告とエラーメッセージを有効にする] チェックボックスをオンにします。[下線] オプションを [警告とエラーに下線を引く] に設定します。

継続的なコードチェックが有効な場合、MATLAB は、エディターおよびライブエディターにコードについての警告とエラーメッセージを表示します。たとえば、サンプルファイル lengthofline.m には、エラーと警告がいくつか含まれています。コードをエディターにコピーし、ファイルを lengthofline.m として保存します。

lengthofline.m コード

function [len,dims] = lengthofline(hline)
%LENGTHOFLINE Calculates the length of a line object
%   LEN = LENGTHOFLINE(HLINE) takes the handle to a line object as the
%   input, and returns its length.  The accuracy of the result is directly
%   dependent on the number of distinct points used to describe the line.
%
%   [LEN,DIM] = LENGTHOFLINE(HLINE) additionally tells whether the line is
%   2D or 3D by returning either a numeric 2 or 3 in DIM.  A line in a
%   plane parallel to a coordinate plane is considered 2D.
%
%   If HLINE is a matrix of line handles, LEN and DIM will be matrices of results.
%
%   Example:
%       figure; h2 = plot3(1:10,rand(1,10),rand(10,5));
%       hold on; h1 = plot(1:10,rand(10,5));
%       [len,dim] = lengthofline([h1 h2])

%   Copyright 1984-2004 The MathWorks, Inc. 

% Find input indices that are not line objects
nothandle = ~ishandle(hline);
for nh = 1:prod(size(hline))
    notline(nh) = ~ishandle(hline(nh)) || ~strcmp('line',lower(get(hline(nh),'type')));
end

len = zeros(size(hline));
for nl = 1:prod(size(hline))
    % If it's a line, get the data and compute the length
    if ~notline(nl)
        flds = get(hline(nl));
        fdata = {'XData','YData','ZData'};
        for nd = 1:length(fdata)
            data{nd} = getfield(flds,fdata{nd});
        end
        % If there's no 3rd dimension, or all the data in one dimension is
        % unique, then consider it to be a 2D line.
        if isempty(data{3}) | ...
               (length(unique(data{1}(:)))==1 | ...
                length(unique(data{2}(:)))==1 | ...
                length(unique(data{3}(:)))==1)
            data{3} = zeros(size(data{1}));
            dim(nl) = 2;
        else
            dim(nl) = 3;
        end
        % Do the actual computation
        temp = diff([data{1}(:) data{2}(:) data{3}(;)]);
        len(nl) = sum([sqrt(dot(temp',temp'))])
    end
end

% If some indices are not lines, fill the results with NaNs.
if any(notline(:))
    warning('lengthofline:FillWithNaNs', ...
        '\n%s of non-line objects are being filled with %s.', ...
        'Lengths','NaNs','Dimensions','NaNs')
    len(notline) = NaN;
    dim(notline) = NaN;
end
    
if nargout > 1
    dims = dim;
end

ファイルのコードアナライザーステータスの表示

エディターまたはライブエディターでファイルを開くと、インジケーターバーの先頭のメッセージインジケーターに、ファイルの全体的なコードアナライザーステータスが表示されます。

メッセージインジケーター	説明
	ファイルに構文エラーまたはその他の重大な問題が含まれています。
	ファイルに警告または改善点が含まれていますが、エラーは含まれていません。
	ファイルにエラー、警告、改善点はいずれも含まれていません。

たとえば、lengthofline.m では、メッセージインジケーターは Red error symbol で、ファイルに少なくとも 1 つのエラーが含まれていることを示しています。

lengthofline file in the Editor with the red error symbol displayed in the indicator bar

コードアナライザーメッセージの表示

メッセージを含む最初のコード部分に移動するには、メッセージインジケーターをクリックします。特定されたコード部分は、エラーの場合に赤色、警告および改善点の場合にオレンジ色で下線が引かれています。ファイルにエラーが含まれている場合は、メッセージインジケーターをクリックすると最初のエラーに移動します。

たとえば、lengthofline.m では、メッセージインジケーターをクリックすると、最初のエラーが発生している 47 行目にカーソルが移動します。MATLAB は、インジケーターバーのエラーマーカーの横にその行のエラーを表示します。複数のメッセージが 1 つの問題あるいは複数の問題を表す場合があります。1 つのメッセージに対処するとそのすべてが解決する場合があります。あるいは、1 つのメッセージに対処した後で他のメッセージが変更されたり、行うべきことが明確になる場合があります。

lengthofline file in the Editor after clicking the message indicator. Three errors display next to the error marker in the indicator bar.

メッセージを含む次のコード部分に移動するには、メッセージインジケーターをクリックします。また、インジケーターバーのマーカーをクリックすると、マーカーのある行に移動できます。たとえば、lengthofline.m でインジケーターバーの最初のマーカーをクリックします。カーソルは 21 行目の先頭に移動します。

コード部分のメッセージを表示するには、下線が引かれているコード部分にマウスポインターを移動します。あるいは、下線が引かれているコード部分にカーソルを置いて Ctrl+M を押します。メッセージに追加情報がある場合は、メッセージに [詳細] ボタンが含まれます。このボタンをクリックすると追加情報が表示され、推奨されるユーザーアクションがある場合はそのアクションも表示されます。

lengthofline file in the Editor showing a warning message with a details button

コード内の問題の修正

コードファイル内の各メッセージについて、メッセージに示された問題を解決するためにコードを変更します。コードを変更すると、メッセージインジケーターと下線は更新されて、ファイルを保存しなくても変更を反映します。

たとえば、lengthofline.m の 47 行目で、メッセージは区切り記号の不均衡を示しています。方向キーを各区切り記号上に移動すると、MATLAB は不一致を示していないように見えます。しかし、コード解析は data{3}(;) 内のセミコロンを検知しており、ステートメントの終わりとして解釈しています。

lengthofline file in the Editor after clicking the message indicator. Three errors display next to the error marker in the indicator bar.

47 行目の問題を解決するには、data{3}(;) を data{3}(:) に変更します。この 1 回の変更により 47 行目のすべてのメッセージが解決され、その行に下線が表示されなくなります。変更によってファイル内の唯一のエラーが削除されたため、バーの最上部のメッセージインジケーターは Red error symbol から Yellow warning symbol に変化し、警告と潜在的な改善点のみが残っていることが示されます。

一部のメッセージでは、問題を修正するために適用できる自動修正が MATLAB によって提示されます。問題に対して自動修正を使用できる場合は、コード部分が強調表示され、メッセージに [修正] ボタンが含まれます。

lengthofline file in the Editor showing a warning message with a fix button

たとえば、lengthofline.m の 27 行目で、下線が付けられ強調表示されたコード部分 prod にカーソルを合わせます。表示されたメッセージに [修正] ボタンが含まれています。

これまでの経験などからこの問題の修正方法がわかっている場合は、[修正] ボタンをクリックするか、Alt+Enter を押します。この問題が不明な場合は、強調表示されているコードを右クリックします。コンテキストメニューの最初の項目に修正候補が表示されます。その項目を選択して修正を適用します。

lengthofline file in the Editor showing the context menu. The first item in the menu is the suggested fix.

問題のインスタンスが複数存在する場合は、問題のすべてのインスタンスに修正候補を適用するように MATLAB によって提案されることがあります。問題のすべてのインスタンスに修正を適用するには、強調表示されているコードを右クリックして [この問題の (n) のインスタンスをすべて修正] を選択します。このオプションは一部の修正候補では使用できません。

コードを修正してすべてのメッセージに対応するか、表示メッセージを無効にすると、メッセージインジケーターが緑色になります。すべてのメッセージに対応済みのサンプルファイル lengthofline2.m を参照してください。

lengthofline2.m コード

function [len,dims] = lengthofline2(hline)
%LENGTHOFLINE Calculates the length of a line object
%   LEN = LENGTHOFLINE(HLINE) takes the handle to a line object as the
%   input, and returns its length.  The accuracy of the result is directly
%   dependent on the number of distinct points used to describe the line.
%
%   [LEN,DIM] = LENGTHOFLINE(HLINE) additionally tells whether the line is
%   2D or 3D by returning either a numeric 2 or 3 in DIM.  A line in a
%   plane parallel to a coordinate plane is considered 2D.
%
%   If HLINE is a matrix of line handles, LEN and DIM will be matrices of results.
%
%   Example:
%       figure; h2 = plot3(1:10,rand(1,10),rand(10,5));
%       hold on; h1 = plot(1:10,rand(10,5));
%       [len,dim] = lengthofline([h1 h2])

%   Copyright 1984-2005 The MathWorks, Inc. 

% Find input indices that are not line objects
nothandle = ~ishandle(hline);
notline = false(size(hline));
for nh = 1:numel(hline)
    notline(nh) = nothandle(nh) || ~strcmpi('line',get(hline(nh),'type'));
end

len = zeros(size(hline));
dim = len;
for nl = 1:numel(hline)
    % If it's a line, get the data and compute the length
    if ~notline(nl)
        flds = get(hline(nl));
        fdata = {'XData','YData','ZData'};
        data = cell(size(fdata));
        for nd = 1:length(fdata)
            data{nd} = flds.(fdata{nd});
        end
        % If there's no 3rd dimension, or all the data in one dimension is
        % unique, then consider it to be a 2D line.
        if isempty(data{3}) || ...
               (length(unique(data{1}(:)))==1 || ...
                length(unique(data{2}(:)))==1 || ...
                length(unique(data{3}(:)))==1)
            data{3} = zeros(size(data{1}));
            dim(nl) = 2;
        else
            dim(nl) = 3;
        end
        % Do the actual computation
        temp = diff([data{1}(:) data{2}(:) data{3}(:)]);
        len(nl) = sum(sqrt(dot(temp',temp'))) %#ok<NOPRT>
    end
end

% If some indices are not lines, fill the results with NaNs.
if any(notline(:))
    warning('lengthofline2:FillWithNaNs', ...
        '\n%s of non-line objects are being filled with %s.', ...
        'Lengths','NaNs','Dimensions','NaNs')
    len(notline) = NaN;
    dim(notline) = NaN;
end
    
if nargout > 1
    dims = dim;
end

コードアナライザーアプリを使用したファイルの解析

R2022b 以降

コードアナライザーアプリを使用して、フォルダー内のすべてのファイルに対してコードアナライザーメッセージのレポートを作成できます。

アプリを開くには、以下のようにします。

MATLAB ツールストリップ: [アプリ] タブの [MATLAB] で、アプリのアイコンをクリックします。
MATLAB コマンドプロンプト: 「codeAnalyzer」と入力します。

Code Analyzer app showing an overall summary of code issues and code health details

`codeIssues` オブジェクトを使用したファイル内の問題の特定および保存

R2022b 以降

codeIssues を使用して、コード内の問題をプログラムによって検出して保存できます。codeIssues オブジェクトは、MATLAB コードアナライザーで検出された問題を保存します。1 つ以上の指定されたファイルまたはフォルダーで検出された問題の並べ替えおよびフィルター処理を、コマンドラインでプログラムによって、またはコードアナライザーアプリで対話的に行うことができます。

たとえば、指定したファイル内の問題が含まれた codeIssues オブジェクトを生成できます。

issues = codeIssues("test.m")

issues = 

  codeIssues with properties:

                         Date: 18-Oct-2022 14:18:54
                      Release: "R2023a"
                        Files: "C:\MyCode\test.m"
    CodeAnalyzerConfiguration: "active"
                       Issues: [3×10 table]
             SuppressedIssues: [0×11 table]


    Issues table preview

    Location    Severity    Fixability                                            Description                                             CheckID    LineStart    LineEnd    ColumnStart    ColumnEnd       FullFilename   
    ________    ________    __________    ____________________________________________________________________________________________    _______    _________    _______    ___________    _________    __________________

    "test.m"      info        manual      "Variable appears to change size on every loop iteration. Consider preallocating for speed."    AGROW          3           3            1             3        "C:\MyCode\test.m"
    "test.m"      info        auto        "Add a semicolon after the statement to hide the output (in a script)."                         NOPTS          6           6            3             3        "C:\MyCode\test.m"
    "test.m"      info        auto        "string('...') is not recommended. Use "..." instead."                                          STRQUOT        8           8            1            13        "C:\MyCode\test.m"

R2023b において: codeIssues オブジェクトに含まれる情報は、exportを使用してエクスポートできます。

MATLAB Online での [コードの問題] パネルを使用したファイルの解析

MATLAB Online™ では、[コードの問題] パネルを使用して、コードに関するエラーおよび警告メッセージを表示できます。[コードの問題] パネルでは、MATLAB コードアナライザーがコードの自動チェック時に検出したコーディングの問題が表示されます。

[コードの問題] パネルを開くには、[エディター] タブまたは [ライブエディター] タブに移動し、[解析] セクションで [コードの問題] をクリックします。あるいは、サイドバーの [パネルをさらに開く] ボタン ( three-dot icon ) を使用してパネルを開くこともできます。既定では、[コードの問題] パネルはデスクトップの右側に開きます。[コードの問題] パネルを非表示にするには、サイドバーの [コードの問題] アイコンをクリックします。

Code Issues panel showing 0 errors and 13 warnings found in the lengthofline.m file. The MATLAB Online desktop right sidebar shows the Code Issues icon.

[コードの問題] パネルで表示するメッセージを、ツールの上部にあるオプションを使用して変更できます。

現在のファイルまたはすべての開いているファイルのメッセージを表示する - [コードの問題] パネルの左上にあるドロップダウンリストを使用して、現在のファイルのエラーおよび警告を表示するのか、すべての開いているファイルのエラーおよび警告を表示するのかを選択します。たとえば、すべての開いているファイルのエラーおよび警告を表示するには、ドロップダウンリストで [開いているファイル] を選択します。
エラーおよび警告の表示/非表示を切り替える - [コードの問題] パネルの右上にある [エラー] ボタンおよび [警告] ボタンを使用して、エラーおよび警告の表示/非表示を切り替えます。たとえば、エラーのみを表示するには、[エラー] ボタンをクリックしてオンにし、[警告] ボタンをオフにします。
テキストでメッセージをフィルター処理する - ドロップダウンリストの下の検索フィールドを使用して、テキストでメッセージのリストをフィルター処理します。たとえば、Variable という単語が含まれているメッセージのみを表示するには、検索フィールドに Variable という単語を入力します。

コードアナライザーメッセージインジケーターとメッセージの調整

現在の開発段階に最も適した状態になるように、下線を表示するコーディング問題のタイプを指定できます。たとえばコーディングを始めるとき、下線はエラー部分のみに表示し、警告は非表示にする必要がある場合があります。下線の基本設定を変更するには、[ホーム] タブの [環境] セクションで、 [基本設定] をクリックします。[MATLAB] 、 [コードアナライザー] を選択し、[下線] オプションを選択します。

また、コードの解析時に表示されるメッセージも調整できます。コード解析では、すべての状況に対応する完全な情報が提供されるわけではありません。場合によってはメッセージを基にしたコード変更を行わないこともあります。コードを変更せず、特定の行に対するインジケーターとメッセージを表示しないようにする場合は、非表示にできます。たとえば、サンプルファイル lengthofline.m の 48 行目にある最初のメッセージは、[(関数内で) 出力を非表示にするには、セミコロンを使ってステートメントを終了してください] です。ステートメントの末尾にセミコロンを付加すると、出力が表示されなくなります。コード解析は出力を生成し、終了セミコロンが欠落している行を通知します。48 行目の出力を表示する場合は、セミコロンを付加しないでください。

警告とエラーメッセージのインジケーターを非表示にするには、次の方法があります。

現在のファイルでメッセージのインスタンスを非表示にする。
現在のファイルでメッセージのすべてのインスタンスを非表示にする。
すべてのファイルでメッセージのすべてのインスタンスを非表示にする。

構文エラーなどのエラーメッセージを非表示にすることはできません。

現在のファイルでメッセージのインスタンスを非表示にする

現在のファイルで指定したコードアナライザーメッセージの特定インスタンスを非表示にすることができます。たとえば、サンプルファイル lengthofline.m の 48 行目にあるメッセージを非表示にするには、48 行目で最初の下線を右クリックして ["(関数内で) 出力を非表示にするには、セミコロンを使って …" を非表示にする] 、 [この行で]を選択します。

コメント %#ok<NOPRT> が行の末尾に表示され、MATLAB はこの行に関するコードアナライザーメッセージ [(関数内で) 出力を非表示にするには、セミコロンを使ってステートメントを終了してください] を抑制するようになります。インジケーターバーには、そのメッセージに対する下線とマークが表示されなくなります。

表示しない 2 つのメッセージが行に含まれている場合は、それぞれの下線を個別に右クリックし、コンテキストメニューから適切な項目を選択します。%#ok 構文が拡張されます。たとえば、サンプルファイル lengthofline.m の 48 行目にある両方のメッセージを非表示にすると、コメント %#ok<NBRAK,NOPRT> が行の末尾に追加されます。

コードアナライザー基本設定でこのメッセージが有効に設定されていても、非表示にしたメッセージの特定インスタンスは表示されません。%#ok は基本設定より優先されます。後で、この行に関するコードアナライザーメッセージ [(関数内で) 出力を非表示にするには、セミコロンを使ってステートメントを終了してください] を表示することにした場合は、行から %#ok<NOPRT> を削除します。

現在のファイルでメッセージのすべてのインスタンスを非表示にする

現在のファイル内で指定したコードアナライザーメッセージのインスタンスをすべて非表示にすることができます。たとえば、サンプルファイル lengthofline.m の 48 行目にあるメッセージのすべてのインスタンスを非表示にするには、48 行目で最初の下線を右クリックして ["(関数内で) 出力を非表示にするには、セミコロンを使って …" を非表示にする] 、 [このファイルで]を選択します。

コメント %#ok<*NOPRT> が行の末尾に表示され、MATLAB は現在のファイル内にあるコードアナライザーメッセージ [(関数内で) 出力を非表示にするには、セミコロンを使ってステートメントを終了してください] のすべてのインスタンスを抑制するようになります。すべての下線と、このメッセージに対するメッセージインジケーターバーのマークが非表示になります。

現在のファイルのどこにも表示しない 2 つのメッセージが行に含まれている場合は、それぞれの下線を個別に右クリックし、コンテキストメニューから適切な項目を選択します。%#ok 構文が拡張されます。たとえば、サンプルファイル lengthofline.m の 48 行目にある両方のメッセージを非表示にすると、コメント %#ok<*NBRAK,*NOPRT> が追加されます。

コードアナライザー基本設定でこのメッセージが有効に設定されていても、このメッセージのインスタンスは表示されません。%#ok は基本設定より優先されます。後で、現在のファイル内にあるコードアナライザーメッセージ [(関数内で) 出力を非表示にするには、セミコロンを使ってステートメントを終了してください] のすべてのインスタンスを表示することにした場合は、行から %#ok<*NOPRT> を削除します。

すべてのファイルでメッセージのすべてのインスタンスを非表示にする

すべてのファイルでコードアナライザーメッセージのすべてのインスタンスを無効にすることができます。たとえば、サンプルファイル lengthofline.m の 48 行目にあるメッセージのすべてのインスタンスをすべてのファイルで非表示にするには、48 行目で最初の下線を右クリックして ["(関数内で) 出力を非表示にするには、セミコロンを使って …" を非表示にする] 、 [すべてのファイルで]を選択します。このオプションによりコードアナライザー基本設定が変更されます。

非表示にするメッセージがわかっている場合は、コードアナライザー基本設定を使用して直接それらを無効にできます。

[ホーム] タブの [環境] セクションで [基本設定] をクリックします。
[MATLAB] 、 [コードアナライザー] を選択します。
メッセージを検索して、非表示にするメッセージを検出します。
すべてのファイルで非表示にする各メッセージに関連するチェックボックスをオフにします。
[OK] をクリックします。

コードアナライザーメッセージ設定の保存と再利用

特定のコードアナライザーメッセージを有効または無効にするオプションを設定し、ファイルにその設定を保存できます。特定のファイルに特定の設定ファイルを使う場合は、コードアナライザー基本設定からその設定ファイルを選択します。他の設定ファイルを選択するまで、その設定ファイルが使用されます。一般的に、特定の設定ファイルをファイルのサブセットに適用する場合に設定ファイルを変更します。

設定をファイルに保存するには、次を行います。

[ホーム] タブの [環境] セクションで [基本設定] をクリックします。
[MATLAB] 、 [コードアナライザー] を選択します。
特定のメッセージまたは特定のメッセージのカテゴリを有効/無効にします。
[アクション] ボタンをクリックして [名前を付けて保存] を選択し、設定を txt ファイルに保存します。
[OK] をクリックします。

任意の MATLAB ファイルの設定を再利用したり、他のユーザーへ設定ファイルを提供することができます。保存した設定を使用するには、次の手順に従います。

[ホーム] タブの [環境] セクションで [基本設定] をクリックします。
[MATLAB] 、 [コードアナライザー] を選択します。
[アクティブ設定] リストを開いて [参照] を選択します。
設定ファイルを選択します。
他のコードアナライザー設定を選択するまで、すべての MATLAB ファイルにこの設定が適用されます。

カスタムチェックの有効化および既存のチェックの構成

R2023a 以降

リソースフォルダーに codeAnalyzerConfiguration.json という名前のファイルを配置することで、コードアナライザーによって MATLAB エディターで表示される既存のチェックを構成したり、カスタムチェックを追加したりすることができます。構成ファイルは、リソースフォルダーおよび任意のサブフォルダーが含まれているフォルダーで有効です。

チェックが有効になっているかどうか、チェックの重大度、メッセージテキスト、パラメーター (チェックにある場合) など、既存のコードアナライザーのチェックを変更できます。たとえば、関数の入出力引数の数を制限します。特定の関数が使用されている場合にトリガーするカスタムチェックを作成することもできます。コードアナライザーのチェックの構成の詳細については、Configure Code Analyzerを参照してください。

関数 matlab.codeanalysis.validateConfiguration を使用して、codeAnalyzerConfiguration.json 構成ファイルの形式が適切であることを検証します。

非表示のメッセージを含むコードの理解

非表示のメッセージを含むコードを受け取った場合、最初にその非表示を解除せずにメッセージを閲覧することが必要な場合があります。メッセージは以下の理由で非表示にされている可能性があります。

1 つ以上の %#ok<message-ID> 命令が <message-ID> で指定されたメッセージを表示するコード行にある。
1 つ以上の %#ok<*message-ID> 命令が <message-ID> で指定されたメッセージを表示するファイルにある。
メッセージは [コードアナライザー基本設定] ペインで無効にされている。
メッセージは既定で無効になっている。

メッセージが非表示にされている原因を調べるには、入力としてファイルを指定して codeIssues を呼び出します。

issues = codeIssues("myFile.m")

出力 issues には、プロパティ SuppressedIssues があり、ファイル内のすべての非表示にされている問題のリストを示した table が含まれています。各問題に関連付けられているメッセージを閲覧し、非表示にされた原因を調べます。

コード解析の制限の理解

コード解析は貴重なツールですが、いくつかの制限があります。

コード解析では、予想されるコードアナライザーメッセージが生成されない場合があります。
コード解析は、一部の問題が検出されないことになっても、返される不正確なメッセージの数を最低限に抑えるように設計されています。
コード解析では、特定の状況に当てはまらないメッセージが生成されることがあります。
[詳細] ボタンをクリックしてメッセージの追加情報を表示すると、メッセージが特定の状況に当てはまるかどうかを判断できます。ほとんどすべてのエラーメッセージは問題です。ただし、警告の多くはコード内で通常とは異なる場所を示しており、場合によっては適切なコードである場合もあります。
メッセージが特定の状況に当てはまらないことに確信がある場合は、警告メッセージを非表示にしてください。確信がもてない場合は、コメントを含めて根拠を示します。これにより、コードを読む人が状況を認識することができます。
詳細については、コードアナライザーメッセージインジケーターとメッセージの調整を参照してください。

関数名と変数名の区別

コード解析では、関数名と変数名を区別できない場合があります。コード解析では、コードアナライザーメッセージが有効になっている場合、以下のコードに対して Code Analyzer cannot determine whether xyz is a variable or a function, and assumes it is a function というメッセージが返されます。コード解析は、xyz に明確な値が割り当てられていないために、これを特定することができません。しかし、コードによって、コード解析が検出できないような方法でワークスペースに値が配置されている可能性があります。

function y=foo(x)
   .
   .
   .
   y = xyz(x);
end

たとえば、以下のコードでは、xyz は関数、あるいは MAT ファイルから読み込まれた変数になります。コード解析で判断する方法はありません。

function y=foo(x)
    load abc.mat
    y = xyz(x);
end

関数 eval、evalc、evalin、assignin を使用する場合にも、コード解析で変数が検出されないことがあります。

コード解析で誤って変数が関数とされる場合は、以下のいずれかを行います。

コード解析により関数として処理されないように変数を初期化します。
関数 load の場合は、load コマンドラインで明示的に変数を指定します。以下に例を示します。
```
 function y=foo(x)
     load abc.mat xyz
     y = xyz(x);
 end
```

構造体とハンドルオブジェクトの区別

コード解析は、構造体とハンドルオブジェクトを区別できない場合があります。次のコードで x が構造体の場合、コードアナライザーメッセージによりコードが構造体の更新した値を使用しないと示されることが予想されます。しかし、x がハンドルオブジェクトの場合は、このコードは正確です。

function foo(x)
		x.a = 3;
end

コード解析では、x が構造体かハンドルオブジェクトかを判断できません。不正確なメッセージの数を最低限に抑えるために、コード解析では、微妙なバグや深刻なバグが含まれている場合でも、前のコードのメッセージを返しません。

組み込み関数とオーバーロード関数の区別

一部の組み込み関数がクラスまたはパスにオーバーロードされている場合は、コードアナライザーメッセージが組み込み関数に該当しても、呼び出すオーバーロード関数には該当しない可能性があります。この場合には、表示される行のメッセージを非表示にするか、ファイル全体のメッセージを非表示にします。

メッセージを非表示にする方法の詳細は、コードアナライザーメッセージインジケーターとメッセージの調整を参照してください。

変数のサイズまたは形状の判断

コード解析では、変数の型および行列の形状を判断する能力が制限されています。これによりコード解析では、ベクトルなど、最も一般的なケースに該当するメッセージが生成される場合があります。ただし、これらのメッセージは、行列などのまれなケースには当てはまらない可能性があります。

スーパークラスのクラス定義の解析

コードアナライザーではスーパークラスのクラス定義をチェックする機能が限られています。たとえば、コードアナライザーはクラスがハンドルクラスであるかどうかを判断できないことがありますが、属性をスーパークラスから継承している場合はクラスで使用されているカスタム属性を検証できる場合もあります。クラス定義を解析する際、コードアナライザーはスーパークラスの情報を使用しようとしますが、特定の判断を行うのに十分な情報が得られない場合が多くあります。

クラスメソッドの解析

ほとんどのクラスメソッドには、同じクラスのオブジェクトである引数が少なくとも 1 つはメソッドとして含まれていなければなりません。しかし、この引数は常に最初の引数である必要はありません。最初の引数の場合、コード解析は、引数が定義しているクラスのオブジェクトであるかどうかを判断でき、さまざまなチェックを実行できます。たとえば、コード解析は、そのプロパティとメソッド名が存在することと、スペルが正しいことをチェックできます。しかし、コード解析は、オブジェクトが定義しているクラスの引数であるかどうかを判断できず、これらのチェックを実行することができません。

MATLAB Compiler デプロイメッセージを有効にする

ファイルを扱う際、このメッセージカテゴリのコードアナライザー基本設定を変更して、MATLAB Compiler デプロイメッセージの表示と非表示を切り替えることができます。これは、展開されたファイルで作業するかどうかによって選択してください。この基本設定を変更すると、エディターの設定も変更されます。同様に、エディターの設定を変更すると、この基本設定も変更されます。ただし、エディターで設定を変更したときにコードアナライザー基本設定が開いていると、その変更は [基本設定] ウィンドウに反映されません。エディターまたは [基本設定] ウィンドウのどちらから設定を変更しても、エディターとコードアナライザーレポートに変更が適用されます。

MATLAB Compiler™ デプロイメッセージを有効にするには、以下の手順を実行します。

[ホーム] タブの [環境] セクションで [基本設定] をクリックします。
[MATLAB] 、 [コードアナライザー] を選択します。
検索フィールドの隣にある下向き矢印をクリックし、[カテゴリ内のメッセージを表示] 、 [MATLAB Compiler (デプロイ) メッセージ] を選択します。
[MATLAB Compiler (デプロイ) メッセージ] カテゴリタイトルの右側の [カテゴリを有効にする] ボタンをクリックします。
コードに表示しないメッセージを個別に解除します。
これらの設定を保存すると決定した場合は、ファイルを展開する作業を次回行うときにそれらの設定を再利用できます。

txt ファイル (コードアナライザーメッセージ設定の保存と再利用での説明のようにして作成できます) の設定は設定のステータスも含みます。

参考

コードアナライザー | codeIssues | checkcode

外部の Web サイト

Programming: Structuring Code (MathWorks Teaching Resources)