]> git.lizzy.rs Git - rust.git/commit
std: Second pass stabilization for thread_local
authorAlex Crichton <alex@alexcrichton.com>
Tue, 30 Dec 2014 23:20:47 +0000 (15:20 -0800)
committerAlex Crichton <alex@alexcrichton.com>
Wed, 31 Dec 2014 23:50:28 +0000 (15:50 -0800)
commitbe11aa6d70c90185db715328ef2b24a3621cb969
treeeba842530fa3f41d6de29cc79e48322d67933541
parent10d99a973498c5a1be6ba318210751efc1c2cf61
std: Second pass stabilization for thread_local

This commit performs a second pass over the `std::thread_local` module. Most of
the functionality remains explicitly unstable, but the specific actions taken
were:

* `thread_local` is now stable
* `thread_local!` is now stable
* `thread_local::Key` is now stable
* `thread_local::Key::with` is now stable
* `thread_local::Key::destroyed` is deprecated in favor of a more general
  `state` function
* `thread_local::Key::state` was added to query the three states that a key can
  be in: uninitialized, valid, or destroyed. This function, and the
  corresponding `State` enum, are both marked unstable as we may wish to expand
  it later on.
* `thread_local::scoped` is entirely unstable. There hasn't been a whole lot of
  usage of this module in the standard distribution, so it remains unstable at
  this time.

Note that while the structure `Key` is marked stable, it is currently forced to
expose all of its implementation details due to the use of
construction-via-macro. The use of construction-via-macro is currently required
in order to place the `#[thread_local]` attribute on static in a
platform-specific manner. These stability attributes were assigned assuming that
it will be acceptable to tweak the implementation of `Key` in the future.
src/libstd/sys/common/thread_info.rs
src/libstd/thread_local/mod.rs
src/libstd/thread_local/scoped.rs