rust-lang / rust-lang/reference

Document lifetime elision rules for `impl trait` in return position

Open
#1,127 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
1.6k
Forks
607
PR merge metrics
PR metrics pending

Description

It looks like there is lifetime elision logic for impl trait in return position, but these rules are not documented in the reference iuc:

The following code type-checks, but does not type-check without the explicit placeholder lifetime + '_:

struct Foo(u32);

// does not type-check without the placeholder lifetime
fn example1(foo: &Foo) -> impl Iterator<Item = u32> + '_ {
    (0..).map(|n: u32| {
        n + foo.0
    })
}

Are the rules the same as the lifetime elision rules for trait objects?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the linked RFC and the Reference's lifetime elision rules, then verify the provided impl Iterator example with and without + '_. Document the applicable lifetime-elision rules for impl Trait in return position and clarify whether they match trait-object rules.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.