スレッド

[アーティクル]
06/09/2015

Microsoft 固有の仕様 →

thread 拡張ストレージクラス修飾子は、スレッドローカル変数を宣言するために使用されます。

__declspec( thread ) declarator

解説

スレッドローカルストレージ (TLS) は、特定のマルチスレッドプロセスの各スレッドが、スレッド固有のデータを格納するための場所を割り当てる機能です。標準のマルチスレッドプログラムでは、データは特定のプロセスのすべてのスレッド間で共有されますが、スレッドローカルストレージはスレッドごとのデータを割り当てるための機能です。スレッドの詳細については、マルチスレッドに関するトピックを参照してください。

スレッドローカル変数の宣言では、拡張属性構文を使用し、__declspec キーワードを thread キーワードと共に使用する必要があります。たとえば、次に示すコードは、整数型のスレッドローカル変数を宣言して特定の値に初期化します。

__declspec( thread ) int tls_i = 1;

スレッドローカルのオブジェクトおよび変数を宣言するときは、以下のガイドラインに従う必要があります。

thread 属性は、データ宣言とデータ定義、およびメンバー関数のないクラスのみに適用できます。thread を関数宣言や関数定義に使用することはできません。
thread 属性の使用は、DLL のインポートの遅延読み込みに干渉する可能性があります。
thread 属性は、静的ストレージ存続期間のあるデータ項目にのみ指定できます。これには、グローバルなデータオブジェクト (static と extern の両方)、ローカルな静的オブジェクト、クラスの静的データメンバーなどが含まれます。 thread 属性を使用して自動データオブジェクトを宣言することはできません。
宣言と定義が同じファイルと別々のファイルのどちらで発生する場合でも、スレッドローカルオブジェクトの宣言と定義には thread 属性を使用する必要があります。
thread 属性を型修飾子として使用することはできません。
__declspec(thread) を使用してインスタンス化できるのは、POD クラスだけです。スレッド属性は、クラス宣言の一部としてオブジェクトが宣言されていない場合は無視されます。次に例を示します。
```
// declspec_thread.cpp
// compile with: /LD
__declspec(thread) class X
{
public:
   int I; 
} x;   // x is a thread object

X y;   // y is not a thread object
```

thread 属性を使用するオブジェクトの宣言は許可されるので、次の 2 つの例は同じ意味になります。

// declspec_thread_2.cpp
// compile with: /LD
__declspec( thread ) class B {
public:
   int data;
} BObject;   // BObject declared thread local.

class B2 {
public:
   int data;
};
__declspec( thread ) B2 BObject2;   // BObject2 declared thread local.

標準 C では、自分自身への参照を含む式でオブジェクトや変数を初期化できます。ただし、この場合のオブジェクトは、非静的なものに限られます。 C++ では、通常、自分自身への参照を含む式でこのようにオブジェクトを動的に初期化できますが、この種の初期化はスレッドローカルオブジェクトでは許可されません。次に例を示します。
```
// declspec_thread_3.cpp
// compile with: /LD
#define Thread __declspec( thread )
int j = j;   // Okay in C++; C error
Thread int tls_i = sizeof( tls_i );   // Okay in C and C++
```
初期化されるオブジェクトが含まれる sizeof 式は、そのオブジェクト自体への参照が発生しないので、C と C++ の両方で有効になります。

END Microsoft 固有の仕様

参照

概念

スレッドローカルストレージ (TLS: Thread Local Storage)

次の方法で共有

スレッド

解説

参照

関連項目

概念

その他のリソース