Uh oh!
There was an error while loading. Please reload this page.
Add more explanation on RefCell::get_mut - #40634
Merged
Merged
Conversation
ghost
reviewed
Mar 18, 2017
GuillaumeGomezforce-pushed
the
refcell-docs
branch
from
March 18, 2017 21:55
bb40d11 to
52cf2a9Comparesteveklabnik
commented
Mar 23, 2017
Contributor
I think the real issue with #40203 is
That is, we need to explain when you would use this method, not just point out that it needs mutable self. |
carols10cents
commented
Apr 17, 2017
Member
Hi @GuillaumeGomez! It looks like @steveklabnik is suggesting some changes to this PR. Just wanted to send a ping to keep this on your radar! |
GuillaumeGomezforce-pushed
the
refcell-docs
branch
from
April 19, 2017 12:24
52cf2a9 to
0b9009eCompareGuillaumeGomez
commented
Apr 19, 2017
MemberAuthor
Updated (finally!). |
Contributor
Nevermind, errors are network related. Restarted the build. |
steveklabnik
commented
Apr 24, 2017
Contributor
@bors: r+ rollup |
bors
commented
Apr 24, 2017
Collaborator
📌 Commit 0b9009e has been approved by |
bors
commented
Apr 24, 2017
Collaborator
🔒 Merge conflict |
GuillaumeGomezforce-pushed
the
refcell-docs
branch
from
April 24, 2017 13:09
0b9009e to
3ad844cCompareGuillaumeGomez
commented
Apr 24, 2017
MemberAuthor
Not sure what went wrong in here... I rebased just in case. @bors: r=steveklabnik rollup |
bors
commented
Apr 24, 2017
Collaborator
📌 Commit 3ad844c has been approved by |
bors
commented
Apr 24, 2017
Collaborator
bors added a commit
that referenced
this pull request
Apr 24, 2017
Add more explanation on RefCell::get_mut Fixes#40203. r? @rust-lang/docs
bors
commented
Apr 24, 2017
Collaborator
☀️ Test successful - status-appveyor, status-travis |
Dylan-DPC added a commit
to Dylan-DPC/rust
that referenced
this pull request
Sep 19, 2022
Tone down explanation on RefCell::get_mut
The language around `RefCell::get_mut` is remarkably sketchy and especially to the novice seems to quite strongly discourage using the method ("be cautious", "Also, please be aware", "special circumstances", "usually not what you want"). It was added six years ago in rust-lang#40634 due to confusion about when to use `get_mut` and `borrow_mut`.
While its signature limits the use-cases for `get_mut`, there is no chance for a safety footgun, and readers can be made aware of `borrow_mut` more softly. I've also just sent a [PR](rust-lang/rust-clippy#9044) to lint situations where `get_mut` could be used to improve ergonomics and performance.
So this PR tones down the language around `get_mut` and also brings it more in line with [`std::sync::Mutex::get_mut()`](https://doc.rust-lang.org/stable/std/sync/struct.Mutex.html#method.get_mut).matthiaskrgr added a commit
to matthiaskrgr/rust
that referenced
this pull request
Sep 19, 2022
Tone down explanation on RefCell::get_mut
The language around `RefCell::get_mut` is remarkably sketchy and especially to the novice seems to quite strongly discourage using the method ("be cautious", "Also, please be aware", "special circumstances", "usually not what you want"). It was added six years ago in rust-lang#40634 due to confusion about when to use `get_mut` and `borrow_mut`.
While its signature limits the use-cases for `get_mut`, there is no chance for a safety footgun, and readers can be made aware of `borrow_mut` more softly. I've also just sent a [PR](rust-lang/rust-clippy#9044) to lint situations where `get_mut` could be used to improve ergonomics and performance.
So this PR tones down the language around `get_mut` and also brings it more in line with [`std::sync::Mutex::get_mut()`](https://doc.rust-lang.org/stable/std/sync/struct.Mutex.html#method.get_mut).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
8 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes#40203.
r? @rust-lang/docs