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

--后填写内容。

相关推荐
白子寰几秒前
【C++打怪之路Lv14】- “多态“篇
开发语言·c++
王俊山IT13 分钟前
C++学习笔记----10、模块、头文件及各种主题(一)---- 模块(5)
开发语言·c++·笔记·学习
为将者,自当识天晓地。15 分钟前
c++多线程
java·开发语言
小政爱学习!17 分钟前
封装axios、环境变量、api解耦、解决跨域、全局组件注入
开发语言·前端·javascript
k093332 分钟前
sourceTree回滚版本到某次提交
开发语言·前端·javascript
神奇夜光杯40 分钟前
Python酷库之旅-第三方库Pandas(202)
开发语言·人工智能·python·excel·pandas·标准库及第三方库·学习与成长
Themberfue42 分钟前
Java多线程详解⑤(全程干货!!!)线程安全问题 || 锁 || synchronized
java·开发语言·线程·多线程·synchronized·
plmm烟酒僧44 分钟前
Windows下QT调用MinGW编译的OpenCV
开发语言·windows·qt·opencv
测试界的酸菜鱼1 小时前
Python 大数据展示屏实例
大数据·开发语言·python
晨曦_子画1 小时前
编程语言之战:AI 之后的 Kotlin 与 Java
android·java·开发语言·人工智能·kotlin