Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

note that find(f) is equivalent to filter(f).next() in the docs. #69501

Merged
merged 1 commit into from
Feb 28, 2020

Conversation

matthiaskrgr
Copy link
Member

@rust-highfive rust-highfive added the S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. label Feb 26, 2020
@@ -2119,6 +2119,7 @@ pub trait Iterator {
///
/// `find()` is short-circuiting; in other words, it will stop processing
/// as soon as the closure returns `true`.
/// `iter.find(f)` is equivalent to `iter.filter(f).next()`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can this go in its own paragraph near the end? It's not really related to the short-circuiting.

@@ -2120,6 +2120,8 @@ pub trait Iterator {
/// `find()` is short-circuiting; in other words, it will stop processing
/// as soon as the closure returns `true`.
///
/// `iter.find(f)` is equivalent to `iter.filter(f).next()`.

This comment was marked as outdated.

@tesuji
Copy link
Contributor

tesuji commented Feb 27, 2020

Another thought: Let's rephrase the sentence:

Note: `Iterator::filter().next()` is equivalent to `Iterator::find(), which is preferable.`

and move it to Iterator::filter doc.

@Dylan-DPC-zz
Copy link

@bors r=ecstatic-morse rollup

@bors
Copy link
Contributor

bors commented Feb 27, 2020

📌 Commit 31b9764 has been approved by ecstatic-morse

@bors bors added S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion. and removed S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. labels Feb 27, 2020
bors added a commit that referenced this pull request Feb 28, 2020
Rollup of 9 pull requests

Successful merges:

 - #69379 (Fail on multiple declarations of `main`.)
 - #69430 (librustc_typeck: remove loop that never actually loops)
 - #69449 (Do not ping PR reviewers in toolstate breakage)
 - #69491 (rustc_span: Add `Symbol::to_ident_string` for use in diagnostic messages)
 - #69495 (don't take redundant references to operands)
 - #69496 (use find(x) instead of filter(x).next())
 - #69501 (note that find(f) is equivalent to filter(f).next() in the docs.)
 - #69527 (Ignore untracked paths when running `rustfmt` on repository.)
 - #69529 (don't use .into() to convert types into identical types.)

Failed merges:

r? @ghost
@bors bors merged commit 0291b6a into rust-lang:master Feb 28, 2020
@matthiaskrgr matthiaskrgr deleted the find_note branch February 29, 2020 14:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants