Add a link to show why unused lifetimes on structs are forbidden

pull/276/head
Yuki Okushi 4 years ago
parent 5d7bec04c8
commit 0d8cefe8dd

@ -13,10 +13,12 @@ struct Iter<'a, T: 'a> {
``` ```
However because `'a` is unused within the struct's body, it's *unbounded*. However because `'a` is unused within the struct's body, it's *unbounded*.
Because of the troubles this has historically caused, unbounded lifetimes and [Because of the troubles this has historically caused][unused-param],
types are *forbidden* in struct definitions. Therefore we must somehow refer unbounded lifetimes and types are *forbidden* in struct definitions.
to these types in the body. Correctly doing this is necessary to have Therefore we must somehow refer to these types in the body.
correct variance and drop checking. Correctly doing this is necessary to have correct variance and drop checking.
[unused-param]: https://rust-lang.github.io/rfcs/0738-variance.html#the-corner-case-unused-parameters-and-parameters-that-are-only-used-unsafely
We do this using `PhantomData`, which is a special marker type. `PhantomData` We do this using `PhantomData`, which is a special marker type. `PhantomData`
consumes no space, but simulates a field of the given type for the purpose of consumes no space, but simulates a field of the given type for the purpose of
@ -25,7 +27,7 @@ the type-system the kind of variance that you want, while also providing other
useful things such as the information needed by drop check. useful things such as the information needed by drop check.
Iter logically contains a bunch of `&'a T`s, so this is exactly what we tell Iter logically contains a bunch of `&'a T`s, so this is exactly what we tell
the PhantomData to simulate: the `PhantomData` to simulate:
```rust ```rust
use std::marker; use std::marker;
@ -63,7 +65,7 @@ soundness. This will in turn allow people to create unsoundness using
Vec's destructor. Vec's destructor.
In order to tell dropck that we *do* own values of type T, and therefore may In order to tell dropck that we *do* own values of type T, and therefore may
drop some T's when *we* drop, we must add an extra PhantomData saying exactly drop some T's when *we* drop, we must add an extra `PhantomData` saying exactly
that: that:
```rust ```rust

Loading…
Cancel
Save