`intrinsic` pragma

[アーティクル]
06/16/2023

pragma の引数リストで指定された関数の呼び出しが組み込みであることを指定します。

構文

#pragma intrinsic(function_1 [,function_2 ... ] )

解説

intrinsicpragma は、関数の動作が既知であることをコンパイラに指示します。コンパイラは、関数を呼び出し、より優れたパフォーマンスを得られる場合は、関数呼び出しをインライン命令に置き換えないことがあります。

組み込み形式のライブラリ関数を以下に示します。コンパイラが intrinsicpragma を検出した後、組み込み関数を含む最初の関数定義に達した時点でそのプラグマが有効になります。その効果は、ソースファイルの最後まで、または同じ組み込み関数を指定した functionpragma が検出されるまで持続します。 intrinsicpragma は、関数定義の外側でのみ (グローバルレベルで) 使用できます。

次の関数は、組み込み形式を持ち、その組み込み形式は /Oi を指定するとき使用されます。

abs
_disable
_enable
fabs
_inp
_inpw

labs
_lrotl
_lrotr
memcmp
memcpy

memset
_outp
_outpw
_rotl
_rotr

strcat
strcmp
strcpy
strlen
_strset

組み込み関数を使用するプログラムが高速な理由は、関数呼び出しのオーバーヘッドがないからです。ただし、追加のコードが生成されるため、サイズが大きくなる可能性があります。

x86 固有の例

_disable および _enable 組み込み関数は、割り込みを無効または有効にするカーネルモード命令を生成するため、カーネルモードドライバーで役立ちます。

コマンドラインで cl -c -FAs sample.c と入力して次のコードをコンパイルし、sample.asm を見て組み込み関数が x86 命令の CLI と STI になることを確認します。

// pragma_directive_intrinsic.cpp
// processor: x86
#include <dos.h>   // definitions for _disable, _enable
#pragma intrinsic(_disable)
#pragma intrinsic(_enable)
void f1(void) {
   _disable();
   // do some work here that should not be interrupted
   _enable();
}
int main() {
}