rust - 为什么 Rust 找不到使用 proc_macro_attribute 生成的枚举的方法?
问题描述
我正在尝试编写将接受 Rust 枚举的过程宏
#[repr(u8)]
enum Ty {
A,
B
}
并为枚举生成一个方法,让我将 u8 转换为允许的变体,像这样
fn from_byte(byte: u8) -> Ty {
match {
0 => Ty::A,
1 => Ty::B,
_ => unreachable!()
}
}
这是我使用proc_macro
lib 实现的。(没有外部库)
#![feature(proc_macro_diagnostic)]
#![feature(proc_macro_quote)]
extern crate proc_macro;
use proc_macro::{TokenStream, Diagnostic, Level, TokenTree, Ident, Group, Literal};
use proc_macro::quote;
fn report_error(tt: TokenTree, msg: &str) {
Diagnostic::spanned(tt.span(), Level::Error, msg).emit();
}
fn variants_from_group(group: Group) -> Vec<Ident> {
let mut iter = group.stream().into_iter();
let mut res = vec![];
while let Some(TokenTree::Ident(id)) = iter.next() {
match iter.next() {
Some(TokenTree::Punct(_)) | None => res.push(id),
Some(tt) => {
report_error(tt, "unexpected variant. Only unit variants accepted.");
return res
}
}
}
res
}
#[proc_macro_attribute]
pub fn procmac(args: TokenStream, input: TokenStream) -> TokenStream {
let _ = args;
let mut res = TokenStream::new();
res.extend(input.clone());
let mut iter = input.into_iter()
.skip_while(|tt| if let TokenTree::Punct(_) | TokenTree::Group(_) = tt {true} else {false})
.skip_while(|tt| tt.to_string() == "pub");
match iter.next() {
Some(tt @ TokenTree::Ident(_)) if tt.to_string() == "enum" => (),
Some(tt) => {
report_error(tt, "unexpected token. this should be only used with enums");
return res
},
None => return res
}
match iter.next() {
Some(tt) => {
let variants = match iter.next() {
Some(TokenTree::Group(g)) => {
variants_from_group(g)
}
_ => return res
};
let mut match_arms = TokenStream::new();
for (i, v) in variants.into_iter().enumerate() {
let lhs = TokenTree::Literal(Literal::u8_suffixed(i as u8));
if i >= u8::MAX as usize {
report_error(lhs, "enum can have only u8::MAX variants");
return res
}
let rhs = TokenTree::Ident(v);
match_arms.extend(quote! {
$lhs => $tt::$rhs,
})
}
res.extend(quote!(impl $tt {
pub fn from_byte(byte: u8) -> $tt {
match byte {
$match_arms
_ => unreachable!()
}
}
}))
}
_ => ()
}
res
}
这就是我使用它的方式。
use helper_macros::procmac;
#[procmac]
#[derive(Debug)]
#[repr(u8)]
enum Ty {
A,
B
}
fn main() {
println!("TEST - {:?}", Ty::from_byte(0))
}
问题是这会导致编译器出错。确切的错误是
error[E0599]: no variant or associated item named `from_byte` found for enum `Ty` in the current scope
--> main/src/main.rs:91:32
|
85 | enum Ty {
| ------- variant or associated item `from_byte` not found here
...
91 | println!("TEST - {:?}", Ty::from_byte(0))
| ^^^^^^^^^ variant or associated item not found in `Ty`
运行cargo expand
虽然生成正确的代码。并且直接运行该代码可以按预期工作。所以我很难过。可能是我遗漏了一些关于应该如何使用 proc_macros 的内容,因为这是我第一次使用它们并且我没有看到任何会导致此错误的东西。我正在关注sorted
proc_macro_workshop 0的部分。唯一的变化是,我直接使用 TokenStream 而不是使用 syn 和 quote crates。此外,如果我输入错误的方法名称,rust 编译器会建议存在具有相似名称的方法。
解决方案
所以,你提到的确实是真的:扩展的代码可以复制粘贴,它会起作用。发生这种情况时(宏扩展和“手动复制粘贴扩展”的行为不同),有两种可能性:
macro_rules!
元变量当使用特殊捕获发出代码时
macro_rules!
,其中一些捕获用特殊的不可见括号包裹,该括号已经告诉解析器应该如何解析里面的东西,这使得在其他地方使用是非法的(例如,一个人可能捕获 a$Trait:ty
,然后做impl $Trait for ...
将失败(它将被解析$Trait
为一种类型,从而导致它被解释为特征对象(旧语法));另请参阅https://github.com/danielhenrymantilla/rust-defile以获取其他示例。这不是你的情况,但记住这一点很好(例如,我最初的预感是,当执行
$tt::$rhs
if$tt
是一个类似:path
的捕获时,那可能会失败)。宏观卫生/透明度和
Span
s例如,考虑:
macro_rules! let_x_42 {() => ( let x = 42; )} let_x_42!(); let y = x;
基本上
x
,宏使用的名称是“污点”的,x
与宏体外部使用的名称不同,正是为了避免在宏需要定义变量等辅助内容时出现误操作。事实证明,这与您的
from_byte
标识符发生的事情是一样的:您的代码发出了from_byte
带有私有卫生/def_site()
跨度的 a,这对于使用经典宏或经典 proc-macros 的方法名称通常不会发生(即,当不使用不稳定的::proc_macro::quote!
宏时)。看到这个评论:https ://github.com/rust-lang/rust/issues/54722#issuecomment-696510769因此,
from_byte
标识符被“污染”,允许 Rust 使其对不属于同一宏扩展的代码不可见,例如fn main
.
在这一点上,解决方案很简单:from_bytes
Ident
使用显式的非 - 伪造一个修饰符def_site()
Span
(例如,,Span::call_site()
甚至更好:Span::mixed_site()
模仿macro_rules!
宏的规则),以防止它获得使用的默认def_site()
Span
值::proc_macro::quote!
:
use ::proc_macro::Span;
// ...
let from_byte = TokenTree::from(Ident::new("from_byte", Span::mixed_site()));
res.extend(quote!(impl $tt {
// use an interpolated ident rather than a "hardcoded one"
// vvvvvvvvvv
pub fn $from_byte(byte: u8) -> $tt {
match byte {
$match_arms
_ => unreachable!()
}
}
}))
推荐阅读
- javascript - React Router 内容在向前刷新或手动输入时不加载
- sql - 如何在 PostgreSQL 中使用 CASE WHEN 而不向聚合和 GROUP BY 添加值?
- nginx - 在 Synology NAS 的 Nginx 配置文件中添加定位站
- asp.net-core - 如何忽略始终开启的 HTTPS Only Azure Appservice 自定义域设置
- javascript - SAP Cloud SDK PATCH MaterialBomItem:触发重新计算物料清单可变尺寸项目中的quantityVariableSizeItem
- linux - Phonegap 无法创建应用程序 - 不是有效的模板
- shell - 检索 XML 标记中的内容
- javascript - 用 v-virtual-scroll 替换 v-data-table
- azure - 为什么 Azure ML Studio 中数据漂移监控的“计算目标”字段仍然空白,而我有一个计算实例?
- c++ - [window terminal][vim] 光标不移动,输入在右箭头或回车前重叠