rust-lang / rust-lang/reference
Least-Upper-Bound coercions don't document special behaviour of coercing to fnptrs
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 1.6k
- Forks
- 607
- PR merge metrics
- PR metrics pending
Description
fn foo() {}
fn bar() {}
let a = match true {
true => foo,
false => bar,
};
Here we wind up with a LUB coercion between two different function item types. This succeeds by coercing both types to function pointers.
The current documentation for type coercions defines LUB coercions as simply trying one-to-one coercion both ways and then trying to compute a mutual supertype if that fails. It should also document that when we have a LUB coercion between function item types and closures we'll coerce to a function pointer if there's no mutual supertype.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start in the Rust Reference section documenting type coercions and read the existing least-upper-bound coercion rules. Update the documentation to state how LUB coercions involving function items or closures fall back to function pointers when no mutual supertype exists, and ensure the provided example is covered by the explanation.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 65/100