Rust:属性(attributes)学习 ,这是啥 -> `#[]`

在 Rust 中,属性(attributes)是一种特殊的语法结构,用于为代码项(如函数、结构体、模块等)提供元数据和附加的编译时指令。属性以 #[attribute_name(arguments...)] 的形式出现,并通常放在它们所修饰的代码项之前。下面是一些 Rust 中属性的具体使用方法:

1. 导出(export

使用 #[export] 属性可以将函数或变量导出为动态链接库(DLL)或共享对象(SO)的一部分。这在创建库时特别有用。

rust 复制代码
rust复制代码
	#[no_mangle]  

	#[export_name = "my_function"]  

	pub extern "C" fn my_function() -> i32 {  

	    // 函数实现  

	    42  

	}

2. 条件编译(cfg

使用 #[cfg(condition)] 属性可以根据编译时条件包含或排除代码块。

csharp 复制代码
rust复制代码
	#[cfg(debug_assertions)]  

	fn debug_only_function() {  

	    // 这个函数只在启用了 debug_assertions 时编译  

	}

3. 链接(link

使用 #[link(name = "library", kind = "static")] 属性可以指定外部库链接。

rust 复制代码
rust复制代码
	#[link(name = "mylib", kind = "static")]  

	extern "C" {  

	    // 外部库函数声明  

	}

4. 派生(derive

使用 #[derive(Trait)] 属性可以自动为结构体或枚举实现某些 trait。这在实现如 DebugCloneEqPartialEq 等常用 trait 时非常有用。

markdown 复制代码
rust复制代码
	#[derive(Debug, Clone)]  

	struct MyStruct {  

	    field1: i32,  

	    field2: String,  

	}

5. 宏(macro

使用 #[macro_use] 属性可以导入宏定义。

markdown 复制代码
rust复制代码
	#[macro_use]  

	extern crate my_macros;  

	  

	// 现在可以在当前模块中使用 my_macros 中定义的宏

6. 测试(test

使用 #[test] 属性可以标记一个函数为测试函数。

csharp 复制代码
rust复制代码
	#[test]  

	fn my_test() {  

	    // 测试代码  

	}

7. 基准测试(bench

使用 #[bench] 属性可以标记一个函数为基准测试函数。

csharp 复制代码
rust复制代码
	#[bench]  

	fn my_bench() {  

	    // 基准测试代码  

	}

8. 自定义属性

除了内置的属性外,Rust 还允许你定义自己的属性,并使用外部工具或插件来处理它们。自定义属性以 #[your_attribute(arguments...)] 的形式出现,并需要相应的工具或插件来解析和处理它们。

scss 复制代码
rust复制代码
	#[my_custom_attribute(arg1 = "value1", arg2 = 42)]  

	fn my_function() {  

	    // 函数实现  

	}

9. 文档属性

文档属性(如 #[doc = "..."] 或直接在代码项上方的文档注释 ///)用于生成 Rust 代码的文档。这些属性可以包含有关函数、结构体、枚举等的描述、用法示例和参数说明。

rust 复制代码
rust复制代码
	/// 这是一个文档注释示例。  

	///  

	/// # 示例  

	/// ```  

	/// let result = my_function(42);  

	/// println!("{}", result);  

	/// ```  

	fn my_function(x: i32) -> i32 {  

	    x * 2  

	}

10. 其他内置属性

Rust 还提供了其他一些内置属性,如 #[inline]#[cold]#[must_use] 等,用于控制代码优化、分支预测和提示编译器行为。

这只是 Rust 属性用法的一部分示例。实际上,Rust 的属性系统非常灵活,并且随着 Rust 语言的发展,新的属性可能会被引入。要获取完整的属性列表和更多详细信息,建议查阅 Rust 的官方文档。

相关推荐
向上的车轮12 小时前
从零实现一个高性能 HTTP 服务器:深入理解 Tokio 异步运行时与 Pin 机制
rust·系统编程·pin·异步编程·tokio·http服务器
AI自动化工坊16 小时前
OpenFang实战指南:用Rust构建高并发AI Agent操作系统
开发语言·人工智能·ai·rust·agent·ai agent
gsls20080818 小时前
tauri开发环境搭建
rust·npm·tauri
Binarydog_Lee18 小时前
Tauri2 开发入门:应用是如何启动的
前端·rust·tauri
changzehai20 小时前
RustRover + J-Link 一键调试 STM32 教程
stm32·单片机·嵌入式硬件·rust·rustrover
咸甜适中20 小时前
rust序列化和反序列化(json、yaml、toml)详解
开发语言·rust·json
IT 行者21 小时前
CentOS 下源码编译安装完整版 Redis 8.0 指南(附 Rust 工具链详解)
redis·rust·centos
暴躁小师兄数据学院21 小时前
【WEB3.0零基础转换笔记】Rust编程篇-第4讲:控制流
开发语言·笔记·rust·web3·区块链·智能合约
武汉唯众智创21 小时前
Rust系统安全实训入门:唯众网络安全实训室搭建与边缘节点并发优化实操指南
人工智能·rust·网络安全实训室建设·rust系统安全实训
怪我冷i2 天前
解决win11运行cargo run的报错,Blocking waiting for file lock on build directory
rust·web·zed·salvo