mathieu/os-rust
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Clarify the flatten specialization comment

Browse source
This commit is contained in:
Josh Stone 2024-02-16 16:08:01 -08:00
parent 974bc455ee
commit c36ae932f9
1 changed files with 2 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
library/core/src/iter/adapters/flatten.rs
View file

@ -917,10 +917,10 @@ where
} }
} }
// Specialization: For iterators that never return more than one item, the `frontiter` and // Specialization: When the inner iterator `U` never returns more than one item, the `frontiter` and
// `backiter` states are a waste, because they'll always have already consumed their item. So in // `backiter` states are a waste, because they'll always have already consumed their item. So in
// this impl, we completely ignore them and just focus on `self.iter`, and we only call the inner // this impl, we completely ignore them and just focus on `self.iter`, and we only call the inner
// `next()` one time. // `U::next()` one time.
// //
// It's mostly fine if we accidentally mix this with the more generic impls, e.g. by forgetting to // It's mostly fine if we accidentally mix this with the more generic impls, e.g. by forgetting to
// specialize one of the methods. If the other impl did set the front or back, we wouldn't see it // specialize one of the methods. If the other impl did set the front or back, we wouldn't see it