attribute的用法总结

本文详细介绍了C++中__attribute__机制的使用,包括函数属性、const参数、noreturn属性以及变量属性等。通过具体实例解析了如何在函数声明中添加属性以增强编译器的功能,并探讨了不同属性的应用场景与注意事项。

ibute)。

__attribute__书写特征是:__attribute__前后都有两个下划线,并切后面会紧跟一对原括弧,括弧里面是相应的__attribute__参数。

__attribute__语法格式为:

__attribute__ ((attribute-list))

其位置约束为:

放于声明的尾部“;”之前。

函数属性(Function Attribute )

函数属性可以帮助开发者把一些特性添加到函数声明中,从而可以使编译器在错误检查方面的功能更强大。 __attribute__ 机制也很容易同非 GNU 应用程序做到兼容之功效。

attribute__ format

该 __attribute__ 属性可以给被声明的函数加上类似 printf 或者 scanf 的特征,它可以使编译器检查函数声明和函数实际调用参数之间的格式化字符串是否匹配。该功能十分有用,尤其是处理一些很难发现的 bug 。

format 的语法格式为:

format (archetype, string-index, first-to-check)

       format 属性告诉编译器,按照 printf, scanf, strftime 或 strfmon 的参数表格式规则对该函数的参数进行检查。 “ archetype ” 指定是哪种风格; “ string-index ” 指定传入函数的第几个参数是格式化字符串; “ first-to-check ” 指定从函数的第几个参数开始按上述规则进行检查。

具体使用格式如下:

__attribute__((format(printf,m ,n )))

__attribute__((format(scanf,m ,n )))

其中参数 m 与 n 的含义为:

m :第几个参数为格式化字符串( format string );

n :参数集合中的第一个,即参数“ … ”里的第一个参数在函数参数总数排在第几,注意,有时函数参数里还有“隐身”的呢,后面会提到;

在使用上, __attribute__((format(printf,m ,n ))) 是常用的,而另一种却很少见到。下面举例说明,其中 myprint 为自己定义的一个带有可变参数的函数,其功能类似于 printf

//m=1 n=2

extern void myprint(const char *format,...) __attribute__((format(printf,1,2)));

//m=2 n=3

extern void myprint(int l , const char *format,...) __attribute__((format(printf,2,3)));

需要特别注意的是,如果 myprint 是一个函数的成员函数,那么 m 和 n 的值可有点“悬乎”了,例如:

//m=3 n=4

extern void myprint(int l , const char *format,...) __attribute__((format(printf,3,4)));

其原因是,类成员函数的第一个参数实际上一个“隐身”的“ this ”指针。(有点 C++ 基础的都知道点 this 指针,不知道你在这里还知道吗?)

__attribute__ const

该属性只能用于带有数值类型参数的函数上。当重复调用带有数值参数的函数时,由于返回值是相同的,所以此时编译器可以进行优化处理,除第一次需要运算外,其它只需要返回第一次的结果就可以了,进而可以提高效率。该属性主要适用于没有静态状态( static state )和副作用的一些函数,并且返回值仅仅依赖输入的参数。

为了说明问题,下面举个非常“糟糕”的例子,该例子将重复调用一个带有相同参数值的函数,具体如下:

 

extern int square(int n) __attribute__((const))

;


...

              

for (i = 0; i < 100; i++ )

               

{

                               

total += square(5) + i;

            

}


通过添加 __attribute__((const)) 声明 ,编译器只调用了函数一次,以后只是直接得到了相同的一个返回值。

事实上, const 参数不能用在带有指针类型参数的函数中,因为该属性不但影响函数的参数值,同样也影响到了参数指向的数据,它可能会对代码本身产生严重甚至是不可恢复的严重后果。

并且,带有该属性的函数不能有任何副作用或者是静态的状态,所以,类似 getchar ()或 time ()的函数是不适合使用该属性的。

        __attribute__((noreturn);

          __attribute__((format(printf, 1, 2))) ;              __attribute__((noreturn, format(printf, 1, 2))) ;             struct test 编译器将以 16 字节(注意是字节 byte 不是位 bit )对齐的方式分配一个变量

同时使用多个属性

可以在同一个函数声明里使用多个 __attribute__ ,并且实际应用中这种情况是十分常见的。使用方式上,你可以选择两个单独的 __attribute__ ,或者把它们写在一起,可以参考下面的例子:

 

/* 

把类似

printf

的消息传递给

stderr 

并退出

 */


extern void die(const char *format, ...)


或者写成


extern void die(const char *format, ...)


如果带有该属性的自定义函数追加到库的头文件里,那么所以调用该函数的程序都要做相应的检查。

需要说明的是, __attribute__ 适用于函数的声明而不是函数的定义。所以,当需要使用该属性的函数时,必须在同一个文件里进行声明

变量属性( Variable Attributes

关键字 __attribute__ 也可以对变量( variable )或结构体成员( structure field )进行属性设置。这里给出几个常用的参数的解释,更多的参数可参考本文给出的连接。

在使用 __attribute__ 参数时,你也可以在参数的前后都加上“ __ ”(两个下划线),例如,使用 __aligned__ 而不是 aligned ,这样,你就可以在相应的头文件里使用它而不用关心头文件里是否有重名的宏定义。

aligned (alignment)

该属性规定变量或结构体成员的最小的对齐格式,以字节为单位。例如:

int x __attribute__ ((aligned (16))) = 0;



         

int x[2] __attribute__ ((packed));



};



packed

使用该属性可以使得变量或者结构体成员使用最小的对齐方式,即对变量是一字节对齐,对域( field )是位对齐。

下面的例子中, x 成员变量使用了该属性,则其值将紧放置在 a 的后面:

           

{




             

char a;



类型属性( Type Attribute

关键字 __attribute__ 也可以对结构体( struct )或共用体( union )进行属性设置。大致有六个参数值可以被设定,即: aligned, packed, transparent_union, unused, deprecated 和 may_alias 。

在使用 __attribute__ 参数时,你也可以在参数的前后都加上“ __ ”(两个下划线),例如,使用 __aligned__ 而不是 aligned ,这样,你就可以在相应的头文件里使用它而不用关心头文件里是否有重名的宏定义。

aligned (alignment)

该属性设定一个指定大小的对齐格式(以字节为单位),例如:

 

struct S { short f[3]; } __attribute__ ((aligned (8)));

typedef int more_aligned_int __attribute__ ((aligned (8)));

 

该声明将强制编译器确保(尽它所能)变量类型为struct S 或者more-aligned-int 的变量在分配空间时采用8 字节对齐方式。

如上所述,你可以手动指定对齐的格式,同样,你也可以使用默认的对齐方式。如果 aligned 后面不紧跟一个指定的数字值,那么编译器将依据你的目标机器情况使用最大最有益的对齐方式。例如:

 

struct S { short f[3]; } __attribute__ ((aligned));

 

这里,如果 sizeof ( short )的大小为 2 ( byte ),那么, S 的大小就为 6 。取一个 2 的次方值,使得该值大于等于 6 ,则该值为 8 ,所以编译器将设置 S 类型的对齐方式为 8 字节。

aligned 属性使被设置的对象占用更多的空间,相反的,使用 packed 可以减小对象占用的空间。

需要注意的是, attribute 属性的效力与你的连接器也有关,如果你的连接器最大只支持 16 字节对齐,那么你此时定义 32 字节对齐也是无济于事的。

packed

使用该属性对 struct 或者 union 类型进行定义,设定其类型的每一个变量的内存约束。当用在 enum 类型定义时,暗示了应该使用最小完整的类型( it indicates that the smallest integral type should be used )。

下面的例子中, my-packed-struct 类型的变量数组中的值将会紧紧的靠在一起,但内部的成员变量 s 不会被“ pack ”,如果希望内部的成员变量也被 packed 的话, my-unpacked-struct 也需要使用 packed 进行相应的约束。

 

struct my_unpacked_struct

{

      char c;

      int i;

};

         

struct my_packed_struct

{

     char c;

     int i;

     struct my_unpacked_struct s;

}__attribute__ ((__packed__));

转自:http://blogold.chinaunix.net/u/26185/showart_2202897.html

 

<think>我们正在讨论的是GCC的__attribute__扩展,而不是用户之前询问的IAR C-STAT。根据提供的引用,用户现在想了解__attribute__的使用方法。引用[1]、[2]、[3]都是关于__attribute__的,而引用[4]和[5]是错误示例,但我们可以忽略它们,因为用户明确要求的是使用方法。 根据引用[1]到[3]的信息,我们可以总结__attribute__的使用方法如下: 1. __attribute__是GCC提供的一种语法,用于向编译器提供关于函数、变量、类型等的额外信息,以便编译器进行优化或特定处理。 2. 它的书写特征是前后各有两个下划线,后面紧跟一对圆括号,括号内是属性列表。即:`__attribute__((attribute-list))`。 3. 它可以放在函数、变量或数据类型的定义之后,但在分号(或逗号,如果多个属性)之前。 我们还可以从引用[1]中得知,使用__attribute__的好处包括提高程序性能、可移植性、可读性、安全性和可维护性。 因此,我们将按照以下结构组织回答: ### 一、基本语法 介绍__attribute__的语法格式,并给出一个简单例子。 ### 二、常见属性及其用法 列举一些常用的属性,并给出代码示例。例如: - `packed`:取消结构体对齐 - `aligned`:设置对齐方式 - `noreturn`:指示函数不会返回 - `deprecated`:标记函数或变量已弃用 - `unused`:标记可能未使用的变量,避免警告 - `section`:将函数或变量放入指定段 - `constructor`和`destructor`:在main函数之前或之后执行的函数 ### 三、使用场景与最佳实践 讨论在什么情况下使用__attribute__以及注意事项。 ### 四、跨平台兼容性 由于__attribute__是GCC特有的,如果考虑跨平台,可以使用宏定义来兼容其他编译器(如MSVC)。 最后,生成相关问题。 注意:我们引用的内容仅限于用户提供的引用[1][2][3],并且要在回答中适当标注引用标记。 由于引用中没有提供具体的代码实例,但引用[1]提到有代码实例,我们可以假设一些常见的代码示例,并标注引用[1]。如果引用中确实没有具体例子,我们就根据知识来编写,但标注引用[1]作为一般性参考。 现在开始组织回答: </think> ### __attribute__ 使用方法详解 `__attribute__` 是 GCC 编译器提供的扩展语法,用于向编译器传递函数/变量/类型的附加属性信息,以优化代码或增强安全性。以下是核心使用方法: --- #### 一、基本语法格式[^2][^3] ```c // 函数声明 void func() __attribute__((attribute_list)); // 变量声明 int var __attribute__((attribute_list)); // 结构体定义 struct my_struct __attribute__((attribute_list)) { ... }; ``` - **核心规则** - 必须使用双下划线:`__attribute__` - 后接**两组括号**:`(( ))` - 属性列表置于内层括号内 --- #### 二、常用属性及代码示例 1. **内存对齐控制** ```c // 变量按 8 字节对齐 int var __attribute__((aligned(8))); // 结构体取消内存填充 struct data { char a; int b __attribute__((packed)); }; ``` - 优化内存访问效率,避免未对齐访问错误 2. **函数行为控制** ```c // 标记函数不返回(如 _exit()) void shutdown() __attribute__((noreturn)); // 强制内联展开 __attribute__((always_inline)) void critical_func(); ``` - 提升性能并帮助编译器优化 3. **错误检查增强** ```c // 参数非空检查 void print(char *str) __attribute__((nonnull(1))); // 函数弃用警告 void old_api() __attribute__((deprecated)); ``` - 编译时触发警告:`print(NULL);` // 产生警告[^1] 4. **自定义段分配** ```c // 将变量放入特定内存段 int buffer[1024] __attribute__((section(".noinit"))); ``` - 适用于嵌入式系统的特殊内存区域管理 --- #### 三、多属性组合使用 ```c // 组合使用 packed + aligned struct __attribute__((packed, aligned(4))) sensor_data { uint8_t id; uint32_t value; }; // 函数多属性声明 __attribute__((noreturn, cold)) void fatal_error() { while(1); // 死循环确保不返回 } ``` - 属性间用**逗号分隔**,无顺序要求 --- #### 四、跨平台兼容方案 ```c // 宏定义兼容不同编译器 #ifdef __GNUC__ #define ATTR_PACKED __attribute__((packed)) #else #define ATTR_PACKED #endif struct data { int a; char b; } ATTR_PACKED; // GCC 下打包,其他编译器忽略 ``` --- #### 五、典型错误及解决 1. **语法错误** 错误示例:`__attribute_(aligned(8))` (缺少下划线和括号) 修正:`__attribute__((aligned(8)))` 2. **属性冲突** ```c // 错误:packed 和 aligned 冲突 struct __attribute__((packed, aligned(16))) conflict; ``` 解决方案:优先满足硬件对齐要求,移除 `packed` 3. **Python 误用**(引用[4][5]) `__attribute__` 是 **C/C++ 专用语法**,在 Python 中出现类似错误(如 `no attribute`)通常是: - 库版本不兼容(如 TensorFlow/Keras) - 对象初始化失败 - 需检查环境配置而非使用 `__attribute__` --- ### 核心价值总结 | 特性 | 作用 | 应用场景 | |------------|--------------------------|-------------------| | 内存控制 | 精细管理数据布局 | 嵌入式系统 | | 性能优化 | 内联/分支预测/对齐 | 高频调用函数 | | 安全增强 | 非空检查/废弃接口警告 | 大型项目维护 | | 硬件适配 | 指定寄存器/内存映射 | 驱动开发 | > 通过合理使用 `__attribute__`,可提升程序 $\text{性能}$、$\text{安全性}$ 和 $\text{可移植性}$,尤其在资源受限的嵌入式系统中至关重要。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值