Iterator::cycle() — document empty iterator special case

rust-lang · Dec 13, 2021 · 7f2f9c6 · 7f2f9c6
1 parent 6d6d089
commit 7f2f9c6
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/library/core/src/iter/traits/iterator.rs b/library/core/src/iter/traits/iterator.rs
@@ -3028,7 +3028,8 @@ pub trait Iterator {
     ///
     /// Instead of stopping at [`None`], the iterator will instead start again,
     /// from the beginning. After iterating again, it will start at the
-    /// beginning again. And again. And again. Forever.
+    /// beginning again. And again. And again. Forever. Note that in case the
+    /// original iterator is empty the resulting iterator will also be empty.
     ///
     /// # Examples
     ///