]> git.lizzy.rs Git - rust.git/commitdiff
auto merge of #19094 : alexcrichton/rust/rm-std-local-data, r=aturon
authorbors <bors@rust-lang.org>
Mon, 24 Nov 2014 09:56:34 +0000 (09:56 +0000)
committerbors <bors@rust-lang.org>
Mon, 24 Nov 2014 09:56:34 +0000 (09:56 +0000)
This commit removes the `std::local_data` module in favor of a new `std::thread_local`
module providing thread local storage. The module provides two variants of TLS:
one which owns its contents and one which is based on scoped references. Each
implementation has pros and cons listed in the documentation.

Both flavors have accessors through a function called `with` which yield a
reference to a closure provided. Both flavors also panic if a reference cannot
be yielded and provide a function to test whether an access would panic or not.
This is an implementation of [RFC 461][rfc] and full details can be found in
that RFC.

This is a breaking change due to the removal of the `std::local_data` module.
All users can migrate to the new tls system like so:

    thread_local!(static FOO: Rc<RefCell<Option<T>>> = Rc::new(RefCell::new(None)))

The old `local_data` module inherently contained the `Rc<RefCell<Option<T>>>` as
an implementation detail which must now be explicitly stated by users.

[rfc]: https://github.com/rust-lang/rfcs/pull/461
[breaking-change]


Trivial merge