coder.updateBuildInfo

RTW.BuildInfo ビルド情報オブジェクトの更新

ページ内をすべて折りたたむ

構文

coder.updateBuildInfo('addCompileFlags',options)

coder.updateBuildInfo('addLinkFlags',options)

coder.updateBuildInfo('addDefines',options)

coder.updateBuildInfo(___,group)

coder.updateBuildInfo('addLinkObjects',filename,path)

coder.updateBuildInfo('addLinkObjects',filename,path,priority,precompiled)

coder.updateBuildInfo('addLinkObjects',filename,path,priority,precompiled,linkonly)

coder.updateBuildInfo(___,group)

coder.updateBuildInfo('addNonBuildFiles',filename)

coder.updateBuildInfo('addSourceFiles',filename)

coder.updateBuildInfo('addIncludeFiles',filename)

coder.updateBuildInfo(___,path)

coder.updateBuildInfo(___,path,group)

coder.updateBuildInfo('addSourcePaths',path)

coder.updateBuildInfo('addIncludePaths',path)

coder.updateBuildInfo(___,group)

説明

coder.updateBuildInfo 関数を使用して、コンパイラとリンカーオプション、プリプロセッサマクロ定義、ソースファイルとインクルードファイル、プリコンパイル済みの外部ライブラリを追加することで、生成された C/C++ ソースコードのビルドプロセスをカスタマイズします。

coder.updateBuildInfo('addCompileFlags',options) は、ビルド情報オブジェクトにコンパイラオプションを追加します。

例

coder.updateBuildInfo('addLinkFlags',options) は、ビルド情報オブジェクトにリンクオプションを追加します。

coder.updateBuildInfo('addDefines',options) は、ビルド情報オブジェクトにプリプロセッサマクロ定義を追加します。

coder.updateBuildInfo(___,group) は、後で参照するためグループ名を options に割り当てます。

coder.updateBuildInfo('addLinkObjects',filename,path) は、ビルド情報オブジェクトにファイルからリンクオブジェクトを追加します。

例

coder.updateBuildInfo('addLinkObjects',filename,path,priority,precompiled) は、リンクオブジェクトがプリコンパイルされているかどうかを示します。

coder.updateBuildInfo('addLinkObjects',filename,path,priority,precompiled,linkonly) は、オブジェクトがリンクされるか、単独でリンク目的で使用される前にビルドされるかどうかを示します。オブジェクトがビルドされる場合、オブジェクトがプリコンパイルされるかどうかを示します。

coder.updateBuildInfo(___,group) は、後で参照するためグループ名をリンクオブジェクトに割り当てます。

coder.updateBuildInfo('addNonBuildFiles',filename) は、ビルド情報オブジェクトに非ビルド関連ファイルを追加します。

coder.updateBuildInfo('addSourceFiles',filename) は、ビルド情報オブジェクトにソースファイルを追加します。

例

coder.updateBuildInfo('addIncludeFiles',filename) は、ビルド情報オブジェクトにインクルードファイルを追加します。

coder.updateBuildInfo(___,path) は、指定したパスのファイルを追加します。

coder.updateBuildInfo(___,path,group) は、後ほど参照するためグループ名をファイルに割り当てます。

coder.updateBuildInfo('addSourcePaths',path) は、ビルド情報オブジェクトにソースファイルパスを追加します。

coder.updateBuildInfo('addIncludePaths',path) は、ビルド情報オブジェクトにインクルードファイルパスを追加します。

例

coder.updateBuildInfo(___,group) は、後で参照するためグループ名をパスに割り当てます。

例

すべて折りたたむ

複数のコンパイラオプションの追加

関数 func のコード生成中にコンパイラオプション -Zi および -Wall を追加します。

func の MATLAB^® コード内の任意の場所に、以下の行を追加します。

coder.updateBuildInfo('addCompileFlags','-Zi -Wall');

codegen コマンドを使用して、func のコードを生成します。コード生成レポートを開きます。

codegen -config:lib -launchreport func

ソースファイル名の追加

関数 calc_factorial のコード生成中に、ソースファイルをプロジェクトのビルド情報に追加します。

C 関数 factorial を宣言するヘッダーファイル fact.h を記述します。
```
 double factorial(double x);
```
fact.h は、ヘッダーファイルとして生成コードに含まれます。このように含めることで、関数が呼び出される前に宣言されるようになります。
ファイルを現在のフォルダーに保存します。

factorial の定義を含む C ファイル fact.c を記述します。factorial は入力の階乗を計算します。

#include "fact.h"
      
      double factorial(double x)
      {
          int i;
          double fact = 1.0;
          if (x == 0 || x == 1) {
             return 1.0;
         } else {
             for (i = 1; i <= x; i++) {
                 fact *= (double)i;
             }
             return fact;
         }
     }

fact.c は、コード生成中にソースファイルとして使用されます。

ファイルを現在のフォルダーに保存します。

外部 C 関数 factorial を呼び出すために coder.ceval を使用する MATLAB 関数 calc_factorial を記述します。
coder.updateBuildInfo をオプション 'addSourceFiles' を指定して使用して、ソースファイル fact.c をビルド情報に追加します。coder.cinclude を使用して、ヘッダーファイル fact.h を生成コードに含めます。
```
function y = calc_factorial(x) %#codegen

  coder.cinclude('fact.h');
  coder.updateBuildInfo('addSourceFiles', 'fact.c');

  y = 0;
  y = coder.ceval('factorial', x);
```
codegen コマンドを使用して、calc_factorial のコードを生成します。
```
 codegen -config:dll -launchreport calc_factorial -args 0
```

リンクオブジェクトの追加

関数 func のコード生成中に、リンクオブジェクト LinkObj.lib をビルド情報に追加します。この例では、リンクオブジェクト LinkObj.lib をローカルフォルダー (たとえば c:\Link_Objects) に保存しておかなければなりません。

func の MATLAB コード内の任意の場所に、以下の行を追加します。

libPriority = '';
libPreCompiled = true;
libLinkOnly = true;
libName = 'LinkObj.lib';
libPath = 'c:\Link_Objects';
coder.updateBuildInfo('addLinkObjects', libName, libPath, ...
     libPriority, libPreCompiled, libLinkOnly);

codegen コマンドを使用して func の MEX 関数を生成します。コード生成レポートを開きます。

codegen -launchreport func

インクルードパスの追加

関数 adder のコード生成中に、インクルードパスをビルド情報に追加します。パスに存在するヘッダーファイル adder.h を含めます。

ヘッダーファイルが現在のフォルダーにない場合に、それらを含めるには以下の方法を使用します。

C 関数 mysum の宣言を含むヘッダーファイル mysum.h を記述します。
```
double mysum(double, double);
```
これを c:\coder\myheaders などのサブフォルダーに保存します。
関数 mysum の定義を含む C ファイル mysum.c を記述します。
```
#include "mysum.h"

double mysum(double x, double y)
 { 
  return(x+y);
 }
 
```
これを現在のフォルダーに保存します。

パス c:\coder\myheaders をビルド情報に追加する MATLAB 関数 adder を記述します。

coder.cinclude を使用して、ヘッダーファイル mysum.h を生成コードに含めます。

function y = adder(x1, x2) %#codegen
   coder.updateBuildInfo('addIncludePaths','c:\coder\myheaders');
   coder.updateBuildInfo('addSourceFiles','mysum.c'); 
     %Include the source file containing C function definition
   coder.cinclude('mysum.h');
   y = 0;
   if coder.target('MATLAB')
      % This line ensures that the function works in MATLAB 
        y = x1 + x2;
   else
       y = coder.ceval('mysum', x1, x2);
    end
end

codegen コマンドを使用して、adder のコードを生成します。
```
codegen -config:lib -launchreport adder -args {0,0}
```

入力引数

すべて折りたたむ

`options` — ビルドオプション
文字ベクトル | string スカラー

ビルドオプション。文字ベクトルまたは string スカラーとして指定します。値はコンパイル時の定数でなければなりません。

先行する引数によって、options はプロジェクトのビルド情報に追加される、関連するビルドオプションを指定します。

先行する引数	`options` の値
`'addCompileFlags'`	コンパイラオプション
`'addLinkFlags'`	リンクオプション
`'addDefines'`	プリプロセッサマクロ定義

関数はオプションをオプションベクトルの最後に追加します。

例: coder.updateBuildInfo('addCompileFlags','-Zi -Wall')

`group` — グループ名
文字ベクトル | string スカラー

ユーザー定義グループの名前。文字ベクトルまたは string スカラーとして指定します。値はコンパイル時の定数でなければなりません。

group オプションは、グループ名を 2 番目の引数のパラメーターに割り当てます。

先行する引数	2 番目の引数	`group` によって名づけられたパラメーター
`'addCompileFlags'`	`options`	コンパイラオプション
`'addLinkFlags'`	`options`	リンクオプション
`'addLinkObjects'`	`filename`	リンク可能なオブジェクトを含むファイルの名前
`'addNonBuildFiles'`	`filename`	非ビルド関連ファイルの名前
`'addSourceFiles'`	`filename`	ソースファイルの名前
`'addSourcePaths'`	`path`	ソースファイルパスの名前

group を使用して、次のことができます。

特定のパラメーターの使用をドキュメント化する。
複数のパラメーターを 1 つのグループとしてまとめて取得または適用する。

`filename` — ファイル名
文字ベクトル | string スカラー

ファイル名。文字ベクトルまたは string スカラーとして指定します。値はコンパイル時の定数でなければなりません。

先行する引数によって、filename はプロジェクトのビルド情報に追加される、関連するファイルを指定します。

先行する引数	`filename` で指定されるファイル
`'addLinkObjects'`	リンク可能なオブジェクトを含むファイル
`'addNonBuildFiles'`	非ビルド関連ファイル
`'addSourceFiles'`	ソースファイル

関数はファイル名をファイル名ベクトルの最後に追加します。

例: coder.updateBuildInfo('addSourceFiles', 'fact.c')

`path` — パス名
文字ベクトル | string スカラー

相対パス名。文字ベクトルまたは string スカラーとして指定します。値はコンパイル時の定数でなければなりません。

先行する引数によって、path はプロジェクトのビルド情報に追加される、関連するパス名を指定します。関数はパスをパス名ベクトルの最後に追加します。

先行する引数	`path` で指定されるパス
`'addLinkObjects'`	リンク可能なオブジェクトへのパス
`'addNonBuildFiles'`	非ビルド関連ファイルへのパス
`'addSourceFiles'`, `'addSourcePaths'`	ソースファイルへのパス

相対パスは、コードを生成する "現在の作業フォルダー" から開始します。相対パス名では、START_DIR マクロを使用して現在の作業フォルダーを参照します。たとえば、ソースファイル fact.c が C:\myCode\mySrcDir に含まれ、C:\myCode からコードを生成するとします。次の例のようにパスを記述します。

例: coder.updateBuildInfo('addSourceFiles','fact.c','$(START_DIR)\mySrcDir')

`priority` — リンクオブジェクトの相対的な優先順位
' '

リンクオブジェクトの優先順位。

この機能は、複数のリンクオブジェクトが追加されるときにのみ適用されます。現在、すべての coder.updateBuildInfo ステートメントに追加できるのは 1 つのリンクオブジェクトファイルのみです。そのためこの機能は使用できません。

後続の引数を使用するには、プレースホルダー引数として '' を含めます。

`precompiled` — リンクオブジェクトがプリコンパイルされているかどうかを示す変数
論理値

リンクオブジェクトがプリコンパイルされているかどうかを示す変数で、論理値として指定されます。値はコンパイル時の定数でなければなりません。

リンクオブジェクトが事前にビルドされ、コンパイルとリンク処理が迅速になっていて、指定した場所に存在する場合、true を指定します。そうでない場合、MATLAB Coder™ ビルドプロセスによってビルドフォルダーにリンクオブジェクトが作成されます。

linkonly が true に設定されている場合、この引数は無視されます。

データ型: logical

`linkonly` — オブジェクトがリンク目的にのみ使用されるべきかどうかを示す変数
論理値

オブジェクトがリンク目的にのみ使用されるべきかどうかを示す変数で、論理値として指定されます。値はコンパイル時の定数でなければなりません。

MATLAB Coder ビルドプロセスが、指定のリンクオブジェクトをビルドするための makefile にルールをビルドまたは生成しないようにする場合、true を指定します。代わりに、最終的な実行可能ファイルをリンクする場合にはプロセスにオブジェクトを含めるだけです。そうでなければ、リンクオブジェクトをビルドするためのルールが makefile に追加されます。

ソースファイルを使用できないリンクオブジェクトを組み込む場合にこの引数を使用できます。

linkonly が true に設定されている場合、precompiled の値は無視されます。

データ型: logical

拡張機能

すべて展開する

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

HDL コード生成
HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

関数 coder.updateBuildInfo は、HDL Coder™ での MATLAB から高位合成 (HLS) へのワークフローのみをサポートします。

バージョン履歴

R2013b で導入

参考

coder.updateBuildInfo

構文

説明

例

複数のコンパイラ オプションの追加

ソース ファイル名の追加

リンク オブジェクトの追加

インクルード パスの追加

入力引数

options — ビルド オプション 文字ベクトル | string スカラー

group — グループ名 文字ベクトル | string スカラー

filename — ファイル名 文字ベクトル | string スカラー

path — パス名 文字ベクトル | string スカラー

priority — リンク オブジェクトの相対的な優先順位 ' '

precompiled — リンク オブジェクトがプリコンパイルされているかどうかを示す変数 論理値

linkonly — オブジェクトがリンク目的にのみ使用されるべきかどうかを示す変数 論理値

拡張機能

C/C++ コード生成 MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成 GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

HDL コード生成 HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

バージョン履歴

参考

トピック

複数のコンパイラオプションの追加

ソースファイル名の追加

リンクオブジェクトの追加

インクルードパスの追加

`options` — ビルドオプション
文字ベクトル | string スカラー

`group` — グループ名
文字ベクトル | string スカラー

`filename` — ファイル名
文字ベクトル | string スカラー

`path` — パス名
文字ベクトル | string スカラー

`priority` — リンクオブジェクトの相対的な優先順位
' '

`precompiled` — リンクオブジェクトがプリコンパイルされているかどうかを示す変数
論理値

`linkonly` — オブジェクトがリンク目的にのみ使用されるべきかどうかを示す変数
論理値

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

HDL コード生成
HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。