スタティックライブラリを正しくインライン化する方法

Question

私は、静的ライブラリとして最終的になる小さなC数学ライブラリを書き直しています。これは、ベクトル演算インターフェイスのインライン展開の恩恵を受けたいと思っています。

私は次があります。

[mymath.h]

... 
... 
extern float clampf(float v, float min, float max); 
... 
... 

[mymath.c]

inline float clampf(float v, float min, float max) 
{ 
    if(v < min) v = min; 
    if(v > max) v = max; 

    return v; 
} 

私のライブラリが静的になり、私はするつもりだので、 .h（および.lib）をユーザーに提供する場合、コンパイル時にclampf関数がプログラムにインライン化されますか？

私は正しいことをしていますが、externを.hに、.cにインラインで宣言していますか？

Answer 1

あなたはそれがほぼ正しいです。あなたは実際にそれを後方に持っています。インライン関数の場合は、ヘッダファイルにinlineの定義を、Cファイルにはexternの宣言を入れる必要があります。

// mymath.h 
inline float clampf(float v, float min, float max) 
{ 
    if(v < min) v = min; 
    if(v > max) v = max; 

    return v; 
} 

// mymath.c 
#include "mymath.h" 
extern float clampf(float v, float min, float max); 

あなたはこのヘッダファイルを含む任意のファイルは、コンパイラがそうすることを選択した場合、インライン定義を使用することができるようになります、ヘッダファイルに定義（フルボディ）を配置する必要があります。

ソースファイルにextern宣言（プロトタイプ）を入れて、ライブラリ内の関数のextern版を出力するようにコンパイラに指示する必要があります。これにより、非インラインバージョン用にライブラリ内の1つの場所が提供されるため、コンパイラは関数をインライン展開するか、共通バージョンを使用するかを選択できます。

これはMSVCコンパイラではうまく動作しない可能性があることに注意してください。これは一般にCのサポートが非常に悪いです（C99はほぼゼロサポート）。 GCCでは、古いバージョンのC99サポートを有効にする必要があります。最新のCコンパイラは、デフォルトでこの構文をサポートしています。

代替：あなたはstatic inlineバージョンを持っているヘッダーを変更することができます

、

// mymath.h 
static inline float clampf(float v, float min, float max) 
{ 
    ... 
} 

しかし、これは機能の非インラインバージョンを提供していませんので、コンパイラがよいです各翻訳単位に対してこの関数のコピーを作成するように強制されます。

注：

1. C99のインライン化規則は正確に直感的ではありません。記事「Inline functions in C」（mirror）に詳細が記載されています。特に、下にスキップし、「インライン関数を使用するための戦略」を参照してください。私は方法＃3を好む、なぜならGCCは今やC99メソッドにデフォルト設定されているからだ。

2. externがデフォルトであるため、技術的には、externを関数宣言（または定義）に置く必要はありません。私はそこに重点的に置いています。

Answer 2

あなたは.hファイルにstatic inlineとしての機能を定義する必要があります。

static inline float clampf(float v, float min, float max) 
{ 
    if(v < min) v = min; 
    if(v > max) v = max; 

    return v; 
} 

関数は.cファイル内に存在してはなりません。

コンパイラは関数をインライン化せず、適切な関数呼び出しにすることがあります。したがって、生成されるすべての.oファイルには、関数のコピーが含まれている可能性があります。