let digit_parser = ('0'..='9').into_parser().map(|val: char| -> i32 { val as i32 - '0' as i32 });
let reduced_left = digit_parser.reduce_left(digit_parser, |lhs, rhs| lhs * 10 + rhs);
let res = rp::parse( &reduced_left, "123456abcd".chars() );
assert_eq!(res.output.unwrap(), (123456,));
assert_eq!(res.it.collect::<String>(), "abcd");

Output：类型 Self 的 Output

reduce_right：减少解析器的输出

给定输入字符串 lhs lhs lhs lhs ... self 和减法器 f，输出将计算为 f(lhs, f(lhs, f(lhs, f( ... f(lhs,self)))

注意

• 还原器的签名必须是 Fn(A0, A1, A2, ..., B0, B1, B2, ...) -> ( B0, B1, B2 ... )。其中 (A0, A1, A2, ...) 是第一个解析器的输出，而 (B0, B1, B2, ...) 是后续解析器的输出。

• 对于单值输出（其输出为 (T,)），返回 T 或 (T,) 都是允许的。

let digit_parser =
    ('0'..='9').into_parser().map(|val: char| -> i32 { val as i32 - '0' as i32 });
let alphabet_parser =
    ('a'..='z').into_parser().map(|val: char| -> i32 { val as i32 - 'a' as i32 });
let reduced_right =
    alphabet_parser.reduce_right(digit_parser, |lhs: i32, rhs: i32| -> i32 { rhs * 10 + lhs });

let res = rp::parse(&reduced_right, "123456dcba".chars());
assert_eq!(res.output.unwrap(), (3654321,));
assert_eq!(res.it.collect::<String>(), "cba");

Output：类型 Self 的 Output

reduce_with：使用初始值对解析器的输出进行还原

给定输入字符串 self self self ... 和还原器 f，输出将计算为 f( f( f(init,self), self), self), ...

还原器的签名必须是 Fn(Init, A0, A1, A2, ...) -> Init。其中 (A0, A1, A2, ...) 是 Self 的输出。

Output: Init

let digit_parser =
    ('0'..='9').into_parser().map(|val: char| -> i32 { val as i32 - '0' as i32 });
let number_parser =
    digit_parser.reduce_with(0, |acc, rhs| acc * 10 + rhs);

let res = rp::parse(&number_parser, "123456abc".chars());
assert_eq!(res.output.unwrap(), (123456,));
assert_eq!(res.it.collect::<String>(), "abc");

reduce_right_with: 使用初始值对解析器的输出进行还原

给定输入字符串 self self self ... 和还原器 f，输出将计算为 f(self, f(self, f(self, f( ... f(self,init)))

归约器的签名必须是 Fn(A0, A1, A2, ..., Init) -> Init。其中 (A0, A1, A2, ...) 是 Self 的输出。

Output: Init

示例

let digit_parser =
    ('0'..='9').into_parser().map(|val: char| -> i32 { val as i32 - '0' as i32 });
let number_rev_parser =
    digit_parser.reduce_right_with(0, |lhs, acc| acc * 10 + lhs);

let res = rp::parse(&number_rev_parser, "123456abc".chars());
assert_eq!(res.output.unwrap(), (654321,));
assert_eq!(res.it.collect::<String>(), "abc");

其他

简单但有用的解析器

constant：这个解析器始终成功，并返回常量值

let parser = rp::constant( (1, 2, 3) );

Output：您提供的元组值

end：如果到达输入的末尾则成功

let end_parser = rp::end();

输出：()

fail：这个解析器始终失败

let parser = rp::fail();

输出：()

void：忽略解析器的输出

强制输出为 ()。它内部调用 match_pattern(...) 而不是 parse(...)。这在您只想检查模式是否匹配时非常有用。更多信息请参阅上面的 match_pattern(...)。

let expensive_parser = 'a'.map(|_| -> i32 {
    // some expensive operations for data extracting...
    panic!("This should not be called");
});
let expensive_parser = expensive_parser.void();

// ignore the output of parser
// this internally calls 'match_pattern(...)' instead of 'parse(...)'
let res = rp::parse(&expensive_parser, "abcd".chars());
assert_eq!(res.output.unwrap(), ());
assert_eq!(res.it.collect::<String>(), "bcd");

输出：()

output：将解析器的输出更改为 (output,)

let digit_parser = ('0'..='9').output(2024);

let res = rp::parse(&digit_parser, "123456hello_world".chars());
assert_eq!(res.output.unwrap(), (2024,));
assert_eq!(res.it.collect::<String>(), "23456hello_world");

Output：(T,) 其中 T 是您提供的值的类型。

string，vec：将匹配的范围捕获到 String 或 Vec<T>

注意

string 只能用于 std::str::Chars，而 vec 只能用于 ExactSizeIterator。

let digits_parser = ('0'..='9').repeat(0..).string();

let res = rp::parse(&digits_parser, "123456hello_world".chars());
assert_eq!(res.output.unwrap(), ("123456".to_string(),));
assert_eq!(res.it.collect::<String>(), "hello_world");

Output：(String,) 或 (Vec<Iterator::Item>,)

not_consume：检查模式是否匹配，而不消耗输入

let digit_parser = ('0'..='9').not_consume();

let res = rp::parse(&digit_parser, "12345".chars());
assert_eq!(res.output.unwrap(), ('1',));
assert_eq!(res.it.collect::<String>(), "12345"); // iterator is not consumed

Output：类型 Self 的 Output