Microsoft 固有の仕様
スレッド ローカル ストレージ (TLS) は、指定されたマルチスレッド プロセスの各スレッドが、スレッド固有のデータを格納するための場所を割り当てる手段です。 標準のマルチスレッド プログラムでは、データは特定のプロセスのすべてのスレッド間で共有されますが、スレッド ローカル ストレージはスレッドごとのデータを割り当てるための機能です。 スレッドの詳細については、Windows SDK の「Processes and Threads」 (プロセスとスレッド) をご覧ください。
Microsoft C 言語には、スレッド ローカル変数を宣言するために __declspec キーワードと共に使用される、拡張ストレージ クラスの属性、スレッドが含まれています。 たとえば、次に示すコードは、整数型のスレッド ローカル変数を宣言して特定の値に初期化します。
__declspec( thread ) int tls_i = 1;
静的に連結されるスレッド ローカル変数を宣言する場合は、次のガイドラインに従ってください。
動的な初期化が含まれているスレッド ローカル変数は、DLL の読み込みを発生させるスレッド、およびプロセスで既に実行されているスレッドでのみ初期化されます。 詳細については、スレッド に関するページを参照してください。
スレッド属性は、データの宣言と定義だけに適用できます。 関数の宣言や定義には使用できません。 たとえば、次のコードはコンパイラ エラーになります。
#define Thread __declspec( thread ) Thread void func(); /* Error */thread 属性は、静的ストレージ存続期間のあるデータ項目にのみ指定できます。 これには、グローバル データ (static と extern の両方) およびローカル スタティック データの両方が含まれます。 自動データは、thread 属性を使用して宣言することはできません。 たとえば、次のコードはコンパイラ エラーになります。
#define Thread __declspec( thread ) void func1() { Thread int tls_i; /* Error */ } int func2( Thread int tls_i ) /* Error */ { return tls_i; }宣言と定義が同じファイルと個別のファイルのどちらで発生するかにかかわらず、スレッド ローカル データの宣言と定義にスレッド属性を使用する必要があります。 たとえば、次のコードはエラーになります。
#define Thread __declspec( thread ) extern int tls_i; /* This generates an error, because the */ int Thread tls_i; /* declaration and the definition differ. */thread 属性を型修飾子として使用することはできません。 たとえば、次のコードはコンパイラ エラーになります。
char *ch __declspec( thread ); /* Error */スレッドのローカル変数のアドレスは定数とは見なされず、またそのようなアドレスが含まれている式は、定数式とは見なされません。 これは、スレッドのローカル変数のアドレスをポインターの初期化子として使用できないことを意味します。 たとえば、コンパイラは次のコードをエラーとします。
#define Thread __declspec( thread ) Thread int tls_i; int *p = &tls_i; /* Error */C では、自分自身を参照している式で変数を初期化できます。ただし、この場合のオブジェクトは、非静的なものに限られます。 次に例を示します。
#define Thread __declspec( thread ) Thread int tls_i = tls_i; /* Error */ int j = j; /* Error */ Thread int tls_i = sizeof( tls_i ) /* Okay */初期化される変数が含まれている sizeof 式は、式自体の参照が発生しないので、有効になります。
__declspec(thread) の使用は、DLL のインポートの遅延読み込みに干渉する可能性があります。
スレッド属性の使用の詳細については、マルチスレッドのトピックに関するページをご覧ください。
Microsoft 固有の仕様はここまで