__declspec
Section spécifique à Microsoft
La syntaxe des attributs étendus pour la spécification des informations de classe de stockage utilise le mot clé __declspec, qui indique qu’une instance d’un type donné doit être stockée avec un attribut de classe de stockage spécifique à Microsoft listé ci-dessous. Parmi les exemples d’autres modificateurs de classe de stockage figurent les mots clés static et extern. Cependant, ces mots clés font partie de la spécification ANSI des langages C et C++ et en tant que tels, ils ne sont pas couverts par la syntaxe des 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-modifieropt
extended-decl-modifier extended-decl-modifier-seq
extended-decl-modifier:
align( nombre )
allocate(" nom-segment ")
allocator
appdomain
code_seg(" nom-segment ")
deprecated
dllimport
dllexport
empty_bases
jitintrinsic
naked
noalias
noinline
noreturn
nothrow
novtable
no_sanitize_address
process
property( { get=nom-fonction-get | ,put=nom-fonction-put } )
restrict
safebuffers
selectany
spectre(nomitigation)
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 ces attributs de classe de stockage spécifiques à Microsoft : align, allocate, allocator, appdomain, code_seg, deprecated, dllexport, dllimport, empty_bases, jitintrinsic, naked, noalias, noinline, noreturn, nothrow, novtable, no_sanitize_address, process, restrict, safebuffers, selectany, spectre 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, empty_bases, naked, noalias, nothrow, no_sanitize_address, property, restrict, selectany, thread et uuid sont des propriétés seulement de la déclaration de l’objet ou de la fonction à laquelle ils sont appliqués. L’attribut thread affecte seulement les données et les objets. Les attributs naked et spectre affectent seulement 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.
Pour la compatibilité avec les versions précédentes, _declspec est un synonyme de __declspec, sauf si l’option du compilateur /Za (Désactiver les extensions de langage) est spécifiée.
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.
Les recommandations générales quant à l’utilisation de l’attribut __declspec pour les déclarations simples sont les suivantes :
decl-specifier-seq init-declarator-list ;
Le decl-specifier-seq doit contenir, parmi d’autres choses, un type de base (par exemple int, float, un typedefou un nom de classe), une classe de stockage (par exemple static, extern) ou l’extension __declspec. La init-declarator-list doit contenir, parmi autres choses, la partie relative au pointeur des déclarations. Par exemple :
__declspec(selectany) int * pi1 = 0; //Recommended, 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;
FIN de la section spécifique à Microsoft