1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
use quote::quote_spanned;
use syn::parse_quote;
use super::{
DelayType, OpInstGenerics, OperatorCategory, OperatorConstraints, OperatorInstance,
OperatorWriteOutput, Persistence, RANGE_0, RANGE_1, WriteContextArgs,
};
use crate::diagnostic::{Diagnostic, Level};
/// > 2 input streams of type `V1` and `V2`, 1 output stream of type `itertools::EitherOrBoth<V1, V2>`
///
/// Zips the streams together, forming paired tuples of the inputs. Note that zipping is done
/// per-tick. Excess items are returned as `EitherOrBoth::Left(V1)` or `EitherOrBoth::Right(V2)`.
/// If you intead want to discard the excess, use [`zip`](#zip) instead.
///
/// ```dfir
/// use dfir_rs::itertools::EitherOrBoth;
///
/// source_iter(0..2) -> [0]my_zip_longest;
/// source_iter(0..3) -> [1]my_zip_longest;
/// my_zip_longest = zip_longest()
/// -> assert_eq([
/// EitherOrBoth::Both(0, 0),
/// EitherOrBoth::Both(1, 1),
/// EitherOrBoth::Right(2),
/// ]);
/// ```
pub const ZIP_LONGEST: OperatorConstraints = OperatorConstraints {
name: "zip_longest",
categories: &[OperatorCategory::MultiIn],
hard_range_inn: &(2..=2),
soft_range_inn: &(2..=2),
hard_range_out: RANGE_1,
soft_range_out: RANGE_1,
num_args: 0,
persistence_args: &(0..=1),
type_args: RANGE_0,
is_external_input: false,
has_singleton_output: false,
flo_type: None,
ports_inn: Some(|| super::PortListSpec::Fixed(parse_quote! { 0, 1 })),
ports_out: None,
input_delaytype_fn: |_| Some(DelayType::Stratum),
write_fn: |&WriteContextArgs {
root,
op_span,
ident,
is_pull,
inputs,
op_name,
op_inst:
OperatorInstance {
generics:
OpInstGenerics {
persistence_args, ..
},
..
},
..
},
diagnostics| {
assert!(is_pull);
let persistence = match persistence_args[..] {
[] => Persistence::Tick,
[a] => a,
_ => unreachable!(),
};
if Persistence::Tick != persistence {
diagnostics.push(Diagnostic::spanned(
op_span,
Level::Error,
format!("`{}()` can only have `'tick` persistence.", op_name),
));
// Fall-thru to still generate code.
}
let lhs = &inputs[0];
let rhs = &inputs[1];
let write_iterator = quote_spanned! {op_span=>
let #ident = #root::dfir_pipes::pull::Pull::zip_longest(
#root::dfir_pipes::pull::Pull::fuse(#lhs),
#root::dfir_pipes::pull::Pull::fuse(#rhs),
);
};
Ok(OperatorWriteOutput {
write_iterator,
..Default::default()
})
},
};