Skip to content

Commit

Permalink
Rollup merge of #113143 - joshtriplett:style-guide-narrow-dereference…
Browse files Browse the repository at this point in the history
…-guidance, r=calebcartwright

style-guide: Narrow guidance about references and dereferencing

The style guide advises "prefer dereferencing to taking references", but
doesn't give guidance on when that "preference" should get overridden by
other considerations. Give an example of when it's fine to ignore
that advice.
  • Loading branch information
matthiaskrgr authored Jun 29, 2023
2 parents c0e37ad + 025dd3a commit 7a7ffce
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion src/doc/style-guide/src/expressions.md
Original file line number Diff line number Diff line change
Expand Up @@ -288,7 +288,8 @@ and other assignment operators such as `+=` or `*=`).

For comparison operators, because for `T op U`, `&T op &U` is also implemented:
if you have `t: &T`, and `u: U`, prefer `*t op u` to `t op &u`. In general,
within expressions, prefer dereferencing to taking references.
within expressions, prefer dereferencing to taking references, unless necessary
(e.g. to avoid an unnecessarily expensive operation).

Use parentheses liberally, do not necessarily elide them due to precedence.
Tools should not automatically insert or remove parentheses. Do not use spaces
Expand Down

0 comments on commit 7a7ffce

Please sign in to comment.