__declspec
Section spécifique à Microsoft
La syntaxe à attributs étendus pour la spécification des informations de classe de stockage utilise le mot clé __declspec, ce qui indique qu'une instance d'un type donné doit être stockée avec un attribut de classe de stockage Microsoft répertorié ci-dessous. Parmi les exemples d'autres modificateurs de classe de stockage figurent les mots clés static et extern. Toutefois, ces mots clés font partie de la spécification ANSI des langages C et C++ et, en tant que tels, ne sont pas couverts par la syntaxe à attributs étendus. La syntaxe à attributs étendus simplifie et normalise les extensions spécifiques à Microsoft pour les langages C et C++.
Grammaire
decl-specifier:
__declspec ( extended-decl-modifier-seq )extended-decl-modifier-seq:
extended-decl-modifieroptionextended-decl-modifier extended-decl-modifier-seq
extended-decl-modifier:
align(#)allocate("segname")
appdomain
code_seg("segname")
deprecated
dllimport
dllexport
jitintrinsic
naked
noalias
noinline
noreturn
nothrow
novtable
process
property({get=get_func_name|,put=put_func_name})
restrict
safebuffers
selectany
thread
uuid("ComObjectGUID")
Un espace blanc sépare la séquence de modificateur de déclaration. Des exemples sont donnés dans des sections ultérieures.
La grammaire des attributs étendus prend en charge les attributs de classe de stockage Microsoft suivants : align, allocate, appdomain, code_seg, deprecated, dllexport, dllimport, jitintrinsic, naked, noalias, noinline, noreturn, nothrow, novtable, process, restrict, safebuffers, selectany et thread. Elle prend également en charge les attributs d'objet COM suivants : property et uuid.
Les attributs de classe de stockage code_seg, dllexport, dllimport, naked, noalias, nothrow, property, restrict, selectany, thread et uuid sont des propriétés uniquement de la déclaration de l'objet ou de la fonction à laquelle ils s'appliquent. L'attribut thread affecte uniquement les données et les objets. L'attribut naked affecte uniquement les fonctions. Les attributs dllimport et dllexport affectent les fonctions, les données et les objets. Les attributs property, selectany et uuid affectent les objets COM.
Les mots clés __declspec doivent être placés au début d'une déclaration simple. Le compilateur ignore sans avertissement les mots clés __declspec placés après * ou & et devant l'identificateur de variable dans une déclaration.
Un attribut __declspec spécifié au début d'une déclaration de type défini par l'utilisateur s'applique à la variable de ce type. Par exemple :
__declspec(dllimport) class X {} varX;
Dans ce cas, l'attribut s'applique à varX. Un attribut __declspec placé après le mot clé class ou struct s'applique au type défini par l'utilisateur. Par exemple :
class __declspec(dllimport) X {};
Dans ce cas, l'attribut s'applique à X.
La recommandation générale en matière d'utilisation de l'attribut __declspec pour les déclarations simples est la suivante :
decl-specifier-seq declarator-list;
decl-specifier-seq doit contenir notamment un type de base (par exemple int, float, typedef ou un nom de classe), une classe de stockage (par exemple static, extern), ou l'extension __declspec. init-declarator-list doit contenir, entre autres, la partie relative au pointeur des déclarations. Par exemple :
__declspec(selectany) int * pi1 = 0; //OK, selectany & int both part of decl-specifier
int __declspec(selectany) * pi2 = 0; //OK, selectany & int both part of decl-specifier
int * __declspec(selectany) pi3 = 0; //ERROR, selectany is not part of a declarator
Le code suivant déclare une variable locale de thread entière et lui affecte une valeur initiale :
// Example of the __declspec keyword
__declspec( thread ) int tls_i = 1;