nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2024-11-26 16:54:01 +00:00
Code Issues Packages Projects Releases Wiki Activity

style-guide: Also format where clauses on one line for short function decls

Browse Source
This commit is contained in:
Josh Triplett 2024-01-10 19:21:27 -08:00
parent 2af29af710
commit 9ff777bf50
1 changed files with 15 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
src/doc/style-guide/src/items.md
View File

@ -295,8 +295,18 @@ Prefer to use single-letter names for generic parameters.
These rules apply for `where` clauses on any item.
If immediately following a closing bracket of any kind, write the keyword
`where` on the same line, with a space before it.
If a where clause is short, and appears on a short one-line function
declaration with no body or a short associated type with no `=`, format it on
the same line as the declaration:
```rust
fn new(&self) -> Self where Self: Sized;
type Item<'a>: SomeTrait where Self: 'a;
```
Otherwise, if immediately following a closing bracket of any kind, write the
keyword `where` on the same line, with a space before it.
Otherwise, put `where` on a new line at the same indentation level. Put each
component of a `where` clause on its own line, block-indented. Use a trailing
@ -424,9 +434,9 @@ bound, put a space after the colon but not before:
type Foo: Bar;
```
If an associated type has no `=`, and has a `where` clause with only one entry,
format the entire type declaration including the `where` clause on the same
line if it fits:
If an associated type is short, has no `=`, and has a `where` clause with only
one entry, format the entire type declaration including the `where` clause on
the same line if it fits:
```rust
type Item<'a> where Self: 'a;