set_directive_inline - 2023.2 日本語

説明

RTL 階層の別エンティティとなっている関数を削除します。インライン展開された関数は呼び出し関数に分解され、別の階層として表示されなくなります。

関数をインライン展開すると、関数内の演算が共有され、呼び出し関数とより効率的に最適化できるようになる場合があります。ただし、インライン展開された関数は共有または再利用できないので、親関数がインライン展開された関数を複数回呼び出す場合、エリアおよびリソース使用率が増加する可能性があります。

デフォルトでは、インライン展開は関数階層のすぐ下の階層でのみ実行されます。

構文

set_directive_inline [OPTIONS] <location>

• <location>: インライン展開を実行する場所を function[/label] の形式で指定します。

オプション

-off

デフォルトでは、Vitis HLS でコードの小さな関数のインライン展開が実行されます。-off オプションを使用すると、指定の関数のインライン展開がディスエーブルになります。

-recursive

デフォルトでは、インライン展開は 1 つの階層でのみ実行されます。指定の関数に含まれる関数はインライン展開されません。-recursive オプションを使用すると、指定の関数階層内のすべての関数が再帰的にインライン展開されます。

重要: データフロー領域内の関数を再帰的にインライン処理すると、データフローの条件を満たさない領域内に関数が 1 つできてしまうことがあります。この場合、INLINE -recursive プラグマまたは指示は無視されます。

例

次の例は、関数 func_sub1 をインライン展開しますが、func_sub1 で呼び出されるサブ関数はインライン展開しません。

set_directive_inline func_sub1

set_directive_inline -recursive func_sub1
set_directive_inline -off func_sub2

関連項目

• pragma HLS inline
• set_directive_allocation