主要内容

生成コ,ドにMATLABコ,ドをコメントとして含める

金宝app®编码器™がある場合,MATLAB函数ブロックに対して生成されたコ,ドにmatlab®ソ,スコ,ドをコメントとして含めることができます。生成コ,ドにこれらの情報を含めることにより、以下が可能になります。

  • 生成コ,ドのソ,スコ,ドとの相互関連付け。

  • 生成コ,ドにおけるアルゴリズムの実装の理解。

  • 生成コ,ドの品質評価。

[コメントとしてmatlabソ,スコ,ドを含める]パラメ,タ,を選択した場合に生成されるコ,ドには以下が含まれます。

  • トレ,サビリティタグの直後のコメントとしてのソ,スコ,ド。トレーサビリティを有効にしてERTターゲットのコードを生成すると(嵌入式编码器®が必要),トレサビリティタグはソスコドにハパリンクされます。詳細にいては,在MATLAB函数块中使用可追溯性(嵌入式编码)を参照してください。

    生成されたコド内でのコメントの場所の例と詳細にいては,生成コ,ド内でのコメントの位置(嵌入式编码)を参照してください。

  • 生成コ,ドの関数本文内の関数のヘルプテキスト。関数のヘルプ テキストは、MATLAB 関数シグネチャの後の最初のコメントです。関数の機能と使い方についての情報を提供します。

    メモ

    嵌入式编码器があれば,生成コードの関数バナー内に関数のヘルプテキストを含めることもできます。詳細にいては,生成コドにmatlabユザコメントを含める(嵌入式编码)を参照してください。

生成コ,ドにコメントとしてMATLABコ,ドを含める

MATLAB函数ブロックに対して生成されたコードにMATLABソースコードをコメントとして含めるには,次の手順に従います。

  1. [cコ,ド]タブで,[コンフィギュレ,ションパラメ,タ,]をクリックします。

  2. [コ,ド生成],[コメント]ペereplicationンで[コメントとしてmatlabソ,スコ,ドを含める]を選択し,[適用]をクリックします。

生成コ,ド内でのコメントの位置

ソ,スコ,ドを含むコメントは,生成コ,ド内でトレ,サビリティタグの後に次のように挿入されます。

/* ':1:18' for y = 1:2:(HEIGHT-4) */
[Stateflowオブジェクトのコメント]パラメ,タ,を選択した場合に生成されるトレ,サビリティコメントは“< S2 >: 1:18”です。[コメントとしてmatlabソ,スコ,ドを含める]パラメ,タ,を選択した場合に生成されるコメントはfor y = 1: 2:(HEIGHT-4)です。

直線ソ,スコ,ド

ソースコードを含むコメントは,ソースコードステートメントを実装する生成コードの前に挿入されます。このコメントは,生成コ,ドの前にある,ユ,ザ,によって追加されたコメントの後に挿入されます。ステ,トメントは関数出力に割り当てられるため,コメントは生成コ,ドから分離されます。

MATLABコド

function [x y] =直线(r,theta) %#codegen %将极坐标转换为直角坐标x = r * cos(theta);Y = r * sin;

コメント付きのcコ,ド

/* MATLAB函数'直线':':1' */ /*转换极坐标为笛卡尔坐标*/ /* ':1:4'X = r * cos(theta);*/ /* '< s1 >:1:5'Y = r * sin;* / straightline0_Y。x =直线0_u。r * cos(line0_u .theta);/*输出:'<根>/y'合并:*输入:'<根>/r' *输入:'<根>/theta' * MATLAB函数块:'<根>/直线' */直线0_y。y =直线0_u。r * sin(line0_u .theta);

如ステ,トメント

如果ステ,トメントに対するコメントは,そのステ,トメントを実装するコ,ドの直前に挿入されます。このコメントは,生成コ,ドの前にある,ユ,ザ,によって追加されたコメントの後に挿入されます。elseif句および其他的句に対するコメントは,その句を実装するコードの直後の,その句の中のステートメントに対して生成されたコードの前に挿入されます。

MATLABコド

函数y = ifstmt(u,v) %#编码原if u > v y = v + 10;Elseif u == v y = u * 2;Else y = v - 10;结束

コメント付きのcコ,ド

/ * MATLAB函数“MLFcn”:“< S1 >: 1 ' */ /* '< S1 >: 1:3如果u >v*/ if (MLFcn_U;u > MLFcn_U.v){/ *外港:“< Root > / y ' */ /* '< S1 >: 1:4Y = v + 10;* / MLFcn_Y。y = MLFcn_U。V + 10.0;} else if (MLFcn_U。u = = MLFcn_U.v){/ *外港:根> < / y ' */ /* '< S1 >: 1:5Elseif u == v*/ /* '< s1 >:1:6'Y = u * 2;* / MLFcn_Y。y = MLFcn_U。U * 2.0;其他}{/ *外港:“< Root > / y ' */ /* '< S1 >: 1:7的其他* / / * < S1 >: 1:8“y = v - 10;* / MLFcn_Y。y = MLFcn_U。V - 10.0;

ステ,トメント

ステートメントヘッダーに対するコメントは,そのヘッダーを実装する生成されたコードの直前に挿入されます。このコメントは,生成コ,ドの前にある,ユ,ザ,によって追加されたコメントの後に挿入されます。

MATLABコド

函数y = forstmt(u) %#编码原y = 0;当i=1时:u y = y + 1;结束

コメント付きのcコ,ド

/ * MATLAB函数“MLFcn”:“< S1 >: 1 ' */ /* '< S1 >: 1:3的y = 0;*/ rtb_y = 0.0;/ * < S1 >: 1:5的i = 1: u*/ for (i = 1.0;i <= MLFcn_U.u;i++) {/* ':1:6'Y = Y + 1;* / rtb_y + +;

而ステ,トメント

ステートメントヘッダーに対するコメントは,そのステートメントヘッダーを実装する生成されたコードの直前に挿入されます。このコメントは,生成コ,ドの前にある,ユ,ザ,によって追加されたコメントの後に挿入されます。

切换到ステ,トメント

开关ステートメントヘッダーに対するコメントは,そのステートメントヘッダーを実装する生成されたコードの直前に挿入されます。このコメントは,生成コ,ドの前にある,ユ,ザ,によって追加されたコメントの後に挿入されます。情况下句および否则句に対するコメントは,その句を実装する生成コードの直後の,その句の中のステートメントに対して生成されたコードの前に挿入されます。

生成コドにmatlabユザコメントを含める

Matlabユ,ザ,コメントには,関数のヘルプテキストやその他のコメントが含まれます。関数のヘルプテキストは,matlab関数シグネチャの後の最初のコメントです。関数の機能と使い方にいての情報を提供します。MATLAB函数ブロックに対して生成されたコドにmatlabユザコメントを含めることができます。

  1. [cコ,ド]タブで,[コンフィギュレ,ションパラメ,タ,]をクリックします。

  2. [コ,ド生成],[コメント]ペereplicationンでMATLAB用户评论(嵌入式编码)を選択し,[適用]をクリックします。

コメントとしてのMATLABソ,スコ,ドの制限

Matlabソ,スコ,ドをコメントとして含める場合,MATLAB函数ブロックには以下の制限があります。

  • Matlabソ,スコ,ドは,以下に対してコメントとして含めることはできません。

    • MathWorks®ルボックスの関数

    • Pコド

    • シミュレ,ションタ,ゲット

    • Stateflow®真值表ブロック

  • コメントの外観と位置は,次の条件によって異なる場合があります。

    • たとえば定数畳み込みなどにより実装コードが消去されていても,生成コード内にまだコメントが見つかることがあります。

    • 関数またはコードブロック全体が消去された場合は,コメントは生成コードから消去される場合があります。

    • 最適化によっては,コメントが生成コ,ドから分離される場合があります。

    • 生成コード内にソースコードのコメントを含めることを選択しなかった場合でも,生成コードはMATLABソースコードからの法的に必要なコメントを含みます。

関連するトピック