__declspec
Específicos de Microsoft
La sintaxis de atributo extendido para especificar información de clase de almacenamiento utiliza la palabra clave __declspec, que especifica que una instancia de un tipo determinado se debe almacenar con un atributo de clase de almacenamiento específico de Microsoft que se muestra a continuación. Ejemplos de otros modificadores de clase de almacenamiento incluyen las palabras clave static y extern. Sin embargo, estas palabras clave forman parte de la especificación ANSI de los lenguajes C y C++ y, como tales no se incluyen en la sintaxis de atributo extendido. La sintaxis de atributo extendido simplifica y normaliza las extensiones específicas de Microsoft a los lenguajes C y C++.
Gramática
decl-specifier:
__declspec ( extended-decl-modifier-seq )extended-decl-modifier-seq:
extended-decl-modifieroptextended-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")
El espacio en blanco separa la secuencia de modificador de la declaración. En secciones posteriores aparecen ejemplos.
La gramática de atributo extendido admite estos atributos de clase de almacenamiento específicos de Microsoft: align, allocate, appdomain, code_seg, deprecated, dllexport, dllimport, jitintrinsic, naked, noalias, noinline, noreturn, nothrow, novtable, process, restrict, safebuffers, selectany y thread. También admite estos atributos de objetos COM: property y uuid.
Los atributos de clase de almacenamiento code_seg, dllexport, dllimport, naked, noalias, nothrow, property, restrict, selectany, thread y uuid son propiedades solo de la declaración del objeto o la función a los que se aplican. El atributo thread solo afecta a datos y objetos. El atributo naked solo afecta a funciones. Los atributos dllimport y dllexport afectan a funciones, datos y objetos. Los atributos property, selectany y uuid afectan a objetos COM.
Las palabras clave __declspec deben colocarse al principio de una declaración simple. El compilador omite, sin advertencia, las palabras clave __declspec situadas después de * o & y delante del identificador de variable en una declaración.
Un atributo __declspec especificado al comienzo de una declaración de tipos definidos por el usuario se aplica a la variable de ese tipo. Por ejemplo:
__declspec(dllimport) class X {} varX;
En este caso, el atributo se aplica a varX. Un atributo __declspec situado después de la palabra clave class o struct se aplica al tipo definido por el usuario. Por ejemplo:
class __declspec(dllimport) X {};
En este caso, el atributo se aplica a X.
La regla general para utilizar el atributo __declspec para las declaraciones simples es la siguiente:
decl-specifier-seq declarator-list;
decl-specifier-seq debe contener, entre otras cosas, un tipo base (por ejemplo, int, float, typedef o un nombre de clase), una clase de almacenamiento (por ejemplo, static, extern) o la extensión __declspec. init-declarator-list debe contener, entre otras cosas, la parte de puntero de declaraciones. Por ejemplo:
__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
El código siguiente declara una variable local de subproceso de entero y la inicializa con un valor:
// Example of the __declspec keyword
__declspec( thread ) int tls_i = 1;