Skip to content

docs: fix incorrect max length in take_while example#101

Merged
atulkhare4096 merged 1 commit into
microsoft:mainfrom
Dailiduzhou:fix/IteratorChainMaxLength
May 1, 2026
Merged

docs: fix incorrect max length in take_while example#101
atulkhare4096 merged 1 commit into
microsoft:mainfrom
Dailiduzhou:fix/IteratorChainMaxLength

Conversation

@Dailiduzhou
Copy link
Copy Markdown
Contributor

Description

This PR corrects a minor inaccuracy in the "Scoped mutability" sidebar regarding the maximum number of elements produced by the iterator chain example.

Why?

The text currently claims that the iterator chain take(10).take_while(...) produces "anywhere from zero to nine elements".

However, if the predicate random::<u8>() % 3 != 0 evaluates to true for all 10 consecutive elements provided by take(10), the resulting collection will contain exactly 10 elements. Thus, the actual range is 0 to 10, not 0 to 9.

The core argument of the paragraph remains perfectly valid: the iterator version can yield 0 elements (failing the "guaranteed-at-least-one" trait of the imperative version). This PR just fixes the understated upper bound.

Changes Made

Updated the text from "zero to nine elements" to "zero to ten elements" to accurately reflect the iterator's potential output.

@4CIDSTAR
Copy link
Copy Markdown

Cool

@atulkhare4096 atulkhare4096 merged commit ae8756c into microsoft:main May 1, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants