diff --git a/src/libstd/keyword_docs.rs b/src/libstd/keyword_docs.rs index ab8a55660cb0c..d025a7d16f256 100644 --- a/src/libstd/keyword_docs.rs +++ b/src/libstd/keyword_docs.rs @@ -159,9 +159,40 @@ mod const_keyword { } // /// Skip to the next iteration of a loop. /// -/// The documentation for this keyword is [not yet complete]. Pull requests welcome! +/// When `continue` is encountered, the current iteration is terminated, returning control to the +/// loop head, typically continuing with the next iteration. /// -/// [not yet complete]: https://github.com/rust-lang/rust/issues/34601 +///```rust +/// // Printing odd numbers by skipping even ones +/// for number in 1..=10 { +/// if number % 2 == 0 { +/// continue; +/// } +/// println!("{}", number); +/// } +///``` +/// +/// Like `break`, `continue` is normally associated with the innermost enclosing loop, but labels +/// may be used to specify the affected loop. +/// +///```rust +/// // Print Odd numbers under 30 with unit <= 5 +/// 'tens: for ten in 0..3 { +/// 'units: for unit in 0..=9 { +/// if unit % 2 == 0 { +/// continue; +/// } +/// if unit > 5 { +/// continue 'tens; +/// } +/// println!("{}", ten * 10 + unit); +/// } +/// } +///``` +/// +/// See [continue expressions] from the reference for more details. +/// +/// [continue expressions]: ../reference/expressions/loop-expr.html#continue-expressions mod continue_keyword { } #[doc(keyword = "crate")]