データ型の関数テンプレート - 2022.1 日本語

データ型の関数テンプレートは、汎用データ型を使用可能な関数です。関数テンプレートを使用すると、複数のデータ型をサポートするライブラリ関数を作成でき、各データ型をサポートするために Model Composer HLS ブロック ライブラリでコードまたはブロックを複製する必要はありません。Model Composer の xmcImportFunction コマンドを使用して、ブロックでサポートされるどのデータ型の信号にでも接続可能な汎用ライブラリ ブロックを作成します。

データ型 (typename) テンプレート パラメーターは、コードおよびシミュレーション ラッパーが生成されるシミュレーション実行時間に解決されます。パラメーターはシミュレーション中にライブラリ ブロックに接続されている信号で指定された実際のデータ型に置き換えられます。置き換えられるデータ型は、データ型の使用 に説明されている Model Composer でサポートされるデータ型である必要があります。

template <typename T>
T max(T x, T y) {
   return (x > y) ? x : y;
}

#include <complex>
template <typename T>
void mult_by_two(std::complex< T > x, std::complex< T > *y)
{
   *Out = In1 * 2;
}

次の例では、関数テンプレートでパラメーター T をカスタマイズ パラメーターとして定義しています。入力引数 x または y に関連付けられていないので、ブロックをモデルに追加したときにユーザーが値を指定する必要があります。

template <typename T>
T min(int x, int y) {
   return (x < y) ? x : y;
}

生成された Library Function ブロックの [Block Parameters] ダイアログ ボックスには、次の図に示すように、テンプレート引数を入力する編集フィールドがあります。

図 1. Library Function の [Block Parameters] ダイアログ ボックス

テンプレート構文では、関数またはクラスのデータ型テンプレート パラメーターをほかのテンプレート パラメーターで指定できます。指定順序は重要ではありません。次に例を示します。

template <typename T1, int ROWS, int COLS, int W, int I>
T1 func(T1 x[ROW][COLS], ap_fixed<W, I> &y) {
...
}

#pragma XMC INPORT x
#pragma XMC INPORT y
#pragma XMC SUPPORTED_TYPES T: int8, int16, int32, double, single, half
template <class T>
T max(T x, T y) {
   return (x > y) ? x : y;
}

#pragma XMC UNSUPPORTED_TYPES T: boolean
#pragma XMC INPORT x, y
template <typename T>
T min(T x, T y) {
   return (x < y) ? x : y;
}

template <typename T>
T min(T x, T y) {
   return (x < y) ? x : y;
}

template <>
bool min<bool>(bool x, bool y) {
...
}

int func(int x);
float func(float x);

template <typename T> 
int func(int x, T y);

template <typename T> 
float func(float x, T y);