Tracking Issue for `OnceCell/Lock::get_mut_or_init`

[tisonkun]

Feature gate: #![feature(once_cell_get_mut)]

This is a tracking issue for

• OnceCell::get_mut_or_init()
• OnceCell::get_mut_or_try_init()
• OnceLock::get_mut_or_init()
• OnceLock::get_mut_or_try_init()

Public API

    pub fn get_mut_or_try_init<F, E>(&mut self, f: F) -> Result<&mut T, E>
    where
        F: FnOnce() -> Result<T, E> { ... }

    pub fn get_mut_or_init<F>(&mut self, f: F) -> &mut T
    where
        F: FnOnce() -> T { ... }

Steps / History

• ACP: Add get_mut_or_init and get_mut_or_try_init for OnceCell libs-team#294
• Implementation: impl get_mut_or_init and get_mut_or_try_init for OnceCell and OnceLock #114788
• Final comment period (FCP)
• Stabilization PR

Unresolved Questions

None yet.

Footnotes

1. https://std-dev-guide.rust-lang.org/feature-lifecycle/stabilization.html ↩

[ChayimFriedman2]

The documentation seems wrong?

Many threads may call get_mut_or_init concurrently with different initializing functions, but it is guaranteed that only one function will be executed.

Since it takes &mut self, this is entirely impossible.

The implementation can likewise be simplified a lot by not using any synchronization.