Rust使用之【宏】

一、简单使用clap

yaml 复制代码
clap = { version = "4.5.17", features = ["derive"] }

其中,什么是features = ["derive"]:表示 你希望在添加 clap 依赖时启用 derive 特性。这通常意味着你希望使用 clap 的派生(derive)宏功能,这些功能可以简化创建命令行接口的代码。例如,derive 特性可以让你使用 #[derive(Parser)] 来自动生成解析命令行参数的代码。

二、简单示例

rust 复制代码
use clap::Parser;
#[derive(Parser, Debug)]
#[command(version, about, long_about = None)]
struct Args {
    #[clap(short, long)]
    name: String,
    #[arg(short, long, default_value_t = 1)]
    count: u8,
}

fn main() {
    let args = Args::parse();

    for _ in 0..args.count {
        println!("Hello {}!", args.name);
    }
    println!("Hello, world!");
}

三、宏

3.1 Rust宏系统

Rust 的宏系统允许你定义和使用宏,以生成代码。宏可以在编译时展开成 Rust 代码,这样你就能以更简洁的方式编写代码。Rust 提供了两种类型的宏:

声明宏 (Declarative Macros):

使用 macro_rules! 语法定义,可以匹配模式并生成代码。

过程宏 (Procedural Macros):

更复杂,可以对 Rust 代码进行复杂的操作,通常使用 #[derive(...)] 或 #[proc_macro] 来定义。

在 clap 库中,#[derive(Parser)] 和 #[command(...)] 是过程宏(procedural macros)的实例,它们在编译时生成代码。

3.2 宏做了什么

宏为你的结构体自动实现了trait,宏的实现是以 Rust 代码的形式存在的,但是它们通常被封装在外部 crate 中,并且在使用时,具体的宏实现是无法直接跳转查看的。编译器知道如何调用这些宏,但它不总是直接提供内部实现的源代码。

3.3 编译

Rust 的宏系统,特别是过程宏(如 #[derive(...)] 和 #[command(...)]),在编译时生成了另外一套代码。

四、简单实现一个宏

这里的示例,帮助理解宏的用法。

比如实现打印一个自定义结构体

如果有一个自定义的结构体,正常println!是并不支持打印任意内容的,这时可以自己实现一个例如to_string的方法将自己的结构体转成String就可以了,如:

rust 复制代码
use my_macros::ToString;

#[derive(ToString)]
struct Person {
    name: String,
    age: u32,
}

fn main() {
    let p = Person {
        name: "Alice".to_string(),
        age: 30,
    };
    println!("{}", p.to_string());
}

其中实现:

rust 复制代码
use proc_macro::TokenStream;
use quote::quote;
use syn::{parse_macro_input, DeriveInput};

#[proc_macro_derive(ToString)]
pub fn to_string_derive(input: TokenStream) -> TokenStream {
    let input = parse_macro_input!(input as DeriveInput);
    let name = &input.ident;
    let fields = if let syn::Data::Struct(syn::DataStruct { fields, .. }) = input.data {
        fields
    } else {
        panic!("ToString only works on structs");
    };

    let field_strings = fields.iter().map(|field| {
        let name = &field.ident;
        quote! {
            format!("{}: {:?}", stringify!(#name), self.#name)
        }
    });

    let expanded = quote! {
        impl #name {
            pub fn to_string(&self) -> String {
                let mut result = String::new();
                #(
                    result.push_str(&format!("{} ", #field_strings));
                )*
                result
            }
        }
    };

    TokenStream::from(expanded)
}

有点类似cpp的宏定义,cpp的宏定义就是单纯的字符串替换,Rust虽说本质上也是单纯的字符串替换,但是Rust的宏展开是编译器功能的一部分,提供了更强大的代码生成能力和更高的安全性。

五、调试启动传递命令内容

如果使用例如RustRover调试启动一个带命令行内容的程序,如下:

shell 复制代码
cargo run -- --name Rust --count 5

在--后填写内容。

相关推荐
lcj251130 分钟前
[C++] C++11
开发语言·c++·笔记
对象存储与RustFS1 小时前
对象锁遇上版本化:删掉的对象还在,真删的又删不掉
后端·docker·云原生
Evand J2 小时前
【MATLAB例程】基于IMM-CKF的AOA+测距融合的二维移动目标跟踪定位
开发语言·matlab·目标跟踪
CappuccinoRose3 小时前
Redis 学习文档
redis·后端·学习·缓存·session·非关系型数据库·gossip
JianZhen✓3 小时前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
FungLeo3 小时前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
我不会起名字3223 小时前
WebSocket 停机与在线状态:Shutdown 返回后还需要清理什么
redis·后端·websocket·go·即时通讯·im·故障排查
七夜zippoe4 小时前
多轮对话管理:Session/记忆在 Java 后端怎么存(存储设计实战)
java·开发语言·ai·session·记忆
屿华AI4 小时前
AUTOSAR 实战-诊断工具 | 基于 Python 与 USB-CANFD 的 UDS 诊断测试工具设计与实现
开发语言·python·测试工具
SomeOtherTime4 小时前
番外篇(第 12 讲):走向工业界深水区——从物理定律看 Rust 在真实工程中的“降维打击”与“阿喀琉斯之踵”
开发语言·rust