Rollup merge of #109565 - WaffleLapkin:better_docs_for_e0223, r=oli-obk

Improve documentation for E0223

See discussion in https://rust-lang.zulipchat.com/#narrow/stream/213817-t-lang/topic/Inconsistency.20in.20prohibiting.20.60Type.3A.3AAssocType.60
This commit is contained in:
Matthias Krüger 2023-03-28 07:01:08 +02:00 committed by GitHub
commit eee3f484f9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -3,31 +3,33 @@ An attempt was made to retrieve an associated type, but the type was ambiguous.
Erroneous code example:
```compile_fail,E0223
trait MyTrait {type X; }
trait Trait { type X; }
fn main() {
let foo: MyTrait::X;
let foo: Trait::X;
}
```
The problem here is that we're attempting to take the type of X from MyTrait.
Unfortunately, the type of X is not defined, because it's only made concrete in
implementations of the trait. A working version of this code might look like:
The problem here is that we're attempting to take the associated type of `X`
from `Trait`. Unfortunately, the type of `X` is not defined, because it's only
made concrete in implementations of the trait. A working version of this code
might look like:
```
trait MyTrait {type X; }
struct MyStruct;
trait Trait { type X; }
impl MyTrait for MyStruct {
struct Struct;
impl Trait for Struct {
type X = u32;
}
fn main() {
let foo: <MyStruct as MyTrait>::X;
let foo: <Struct as Trait>::X;
}
```
This syntax specifies that we want the X type from MyTrait, as made concrete in
MyStruct. The reason that we cannot simply use `MyStruct::X` is that MyStruct
might implement two different traits with identically-named associated types.
This syntax allows disambiguation between the two.
This syntax specifies that we want the associated type `X` from `Struct`'s
implementation of `Trait`.
Due to internal limitations of the current compiler implementation we cannot
simply use `Struct::X`.