コードのセクションの作成と実行

R2021b 以降

多くの場合、MATLAB^® コードファイルには多数のコマンドとテキスト行が含まれます。通常、一度にコードの 1 か所に集中して作業し、コードと関連テキストは複数の部分に分けて処理されます。ドキュメントの管理と操作をより容易にするには、ファイルをセクションに分割します。その後、必要に応じて、個々のセクションのコードを実行したり、セクション間を移動したりできます。

File open in the Editor showing two sections. The second section has a blue border around it indicating that it is the selected section.

ファイルをセクションに分割

セクションを作成するには、[エディター] タブまたは [ライブエディター] タブに移動し、[セクション] セクションで [セクション区切り] ボタンをクリックします。また、新しいセクションを開始する行の先頭に 2 つのパーセント記号 (%%) を入力することもできます。新しいセクションは青色の輪郭線で強調表示され、それが選択されていることが示されます。コードファイル内のセクションが 1 つのみの場合、セクションは常に選択されているため、強調表示されません。

エディターでは、セクションは 2 つのパーセント記号 (%%) で始まります。%% 行のテキストは "セクションタイトル" と呼ばれます。セクションタイトルを含めるのは任意ですが、セクションタイトルを入れるとファイルが読みやすくなり、コードをパブリッシュする場合はこれが見出しとして表示されます。

File open in the Editor showing two percent signs on line eight and a blue border above line eight indicating the start of the section

ライブエディターでは、セクションはコード、テキスト、および出力で構成できます。セクションを作成するか既存のセクションを変更すると、セクションの左側の縦のバーが縞模様で表示されます。この縞模様は、セクションが "古い" ことを示しています。古いセクションとは、まだ実行されていないか、最後の実行以降に変更されたセクションのことです。

File open in the Live Editor showing a blank code line on line eight and a blue border above line eight indicating the start of the section

セクションの削除

エディターでセクション区切りを削除するには、セクションの先頭にある 2 つのパーセント記号 (%%) を削除します。ライブエディターでセクション区切りを削除するには、セクション区切りの直後の行の先頭にカーソルを合わせ、Backspace キーを押します。または、セクション区切りの直前の行の末尾にカーソルを合わせ、Delete キーを押すこともできます。

メモ

MATLAB によって追加されたセクション区切りは削除できません。MATLAB によってセクション区切りが追加される可能性がある状況の詳細については、関数でのセクションの動作およびループと条件付きステートメントでのセクションの動作を参照してください。

セクションの余白の最小化

エディターでのコードの編集に使用できるスペースを最大にするには、[セクションの実行]、[ここまで実行] および [コードの折りたたみ] の余白を非表示にできます。これにより、コードの左側にあるグレーの領域が最小になります。1 つ以上の余白を非表示にするには、コードの左側にあるグレーの領域を右クリックし、[[セクションの実行] の余白を表示]、[[ここまで実行] の余白を表示] と [[コードの折りたたみ] の余白を表示] のオプションをオフにします。

セクションの実行

コードファイルを実行するときは、各セクションを個々に実行するか、ファイル内のすべてのコードを一度に実行できます。セクションを個々に実行するには、セクションに必要な値がすべて含まれているか、値が MATLAB ワークスペースに存在していなければなりません。セクションを個々に実行する場合、MATLAB でファイルは保存されず、ファイルが検索パス上にある必要はありません。

次の表では、コードを実行するためのさまざまな方法を説明しています。

操作	手順
ファイル内のすべてのコードを実行する。	[エディター] タブまたは [ライブエディター] タブの [実行] セクションで、 [実行] をクリックします。
選択されたセクション内のコードを実行する。	[エディター] タブまたは [ライブエディター] タブの [セクション] セクションで、 [セクションの実行] をクリックします。ライブエディターでは、セクションの左側にある青いバーをクリックすることもできます。
選択されたセクションのコードを実行し、次のセクションに移動する。	[エディター] タブまたは [ライブエディター] タブの [セクション] セクションで、 [実行して次に進む] を選択します。
選択セクション内のコードを実行し、その後、選択したセクションの後にあるすべてのコードを実行する。	[エディター] タブまたは [ライブエディター] タブの [セクション] セクションで、 [最後まで実行] を選択します。
特定のコード行まで実行して一時停止する。	行の左側にある [ここまで実行] ボタンをクリックします。選択した行に到達できない場合、MATLAB はファイルの終わりかブレークポイントに達するまで実行を続けます。エディターでは、 [ここまで実行] ボタンは保存済みのコードに対してのみ使用できます。ライブエディターでは、 [ここまで実行] ボタンは保存済みかどうかに関係なくすべてのコードに対して使用できます。関数とクラスでは、 [ここまで実行] ボタンは評価の一時停止中にのみ使用できます。詳細については、MATLAB コードファイルのデバッグを参照してください。

セクションの値のインクリメント

R2023a 以降

エディターで、セクション内の数値のインクリメント、デクリメント、乗算、または除算を行って、変更を行うたびにそのセクションを再実行することができます。このワークフローは、コードの微調整および試行に役立ちます。

数値を調整するには、値を選択するか、カーソルを値の横に置きます。次に、右クリックして [値のインクリメントおよびセクションの実行] を選択します。表示されたダイアログボックスで、加算および減算のステップ値、または乗算および除算のスケール値を指定します。次に、演算子ボタンのいずれかをクリックして、セクション内の選択した値に対する加算、減算、乗算、または除算を行います。MATLAB は、クリックするたびにセクションを実行します。

Increment Value and Run Section dialog box with the step value for addition and subtraction set to 1 and the scale value for multiplication and division set to 1.1

ライブエディターで、コントロールを使用してセクション内の数値をインクリメントおよびデクリメントできます。たとえば、次のコードでは変数 x の階乗を計算しています。

x = 5;
y = factorial(x)

y =
   120

x の値を対話的に変更するには、ライブスクリプトで値 5 を数値スライダーに置き換えます。既定では、スライダーの値が変更されると MATLAB で現在のセクションが再実行されます。

Code that calculates the factorial of x. The value of x is replaced with a numeric slider with a minimum value of 0, a maximum value of 10, and an actual value of 5.

詳細については、ライブスクリプトへの対話型コントロールの追加を参照してください。

セクション間の移動

セクション内のコードを実行せずに、ファイルのセクション間を移動できます。このナビゲーションにより、ファイル内でセクション間をすばやく簡単に移動できます。この方法で移動すると、大きいファイル内で特定のコードを検索するときなどに便利です。

操作	手順
特定のセクションに移動する。	[エディター] タブまたは [ライブエディター] タブの [ナビゲート] セクションで、 [移動] のをクリックします。次に、[セクション] セクションで、使用可能なオプションから選択します。
前のセクションに移動する。	[エディター] タブまたは [ライブエディター] タブの [ナビゲート] セクションで、 [移動] のをクリックし、[前のセクション] をクリックします。代わりに、キーボードショートカットの Ctrl + 上矢印も使用できます。
次のセクションに移動する	[エディター] タブまたは [ライブエディター] タブの [ナビゲート] セクションで、 [移動] のをクリックし、[次のセクション] をクリックします。代わりに、キーボードショートカットの Ctrl + 下矢印も使用できます。

関数でのセクションの動作

エディターで関数内にセクション区切りを追加すると、MATLAB はセクション区切りを関数宣言と関数の end ステートメントに挿入します。end ステートメントで関数を終了しない場合、MATLAB は次の関数の直前で関数を終了します。

ループと条件付きステートメントでのセクションの動作

エディターでループまたは条件付きステートメント (if ステートメントや for ループなど) の内部にセクション区切りを追加すると、MATLAB はステートメントの開始と終了を含む行にセクション区切りを追加します (それらの行にまだセクション区切りがない場合)。ループまたは条件付きステートメントの内部のセクションは、残りのコードのセクションから独立しており、残りのコードのセクション内で入れ子になります。入れ子になったループまたは条件付きステートメントの内部のセクションも入れ子になります。

たとえば、次のコードは、10 要素のベクトルをあらかじめ割り当て、9 つの値を計算します。計算値が偶数の場合、MATLAB は 1 を加算します。

x = ones(1,10);
for n = 2:10

    x(n) = 2 * x(n - 1);
    if rem(x(n), 2) == 0
        
        x(n) = x(n) + 1;
    end
end

3 行目の for ループの内部にセクション区切りを追加すると、MATLAB は 9 行目の for ループの end ステートメントにセクション区切りを追加します。6 行目の if ステートメントの内部にセクション区切りを追加すると、MATLAB は 8 行目の if ステートメントの end ステートメントにセクション区切りを追加し、入れ子のセクションのレベルが 3 つになります。

入れ子の最上位レベルでは、1 つのセクションがファイル全体に相当します。
入れ子の 2 番目のレベルでは、セクションは for ループ内にあります。
入れ子の 3 番目のレベルでは、1 つのセクションが if ステートメント内にあります。