a9c1152c4b
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 thread local 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]
101 lines
2.4 KiB
Rust
101 lines
2.4 KiB
Rust
// Copyright 2014 The Rust Project Developers. See the COPYRIGHT
|
|
// file at the top-level directory of this distribution and at
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
|
|
#![allow(missing_docs)]
|
|
#![allow(dead_code)]
|
|
|
|
use io::{mod, IoError, IoResult};
|
|
use prelude::*;
|
|
use sys::{last_error, retry, fs};
|
|
use c_str::CString;
|
|
use num::Int;
|
|
use path::BytesContainer;
|
|
use collections;
|
|
|
|
pub mod net;
|
|
pub mod helper_thread;
|
|
pub mod thread_local;
|
|
|
|
// common error constructors
|
|
|
|
pub fn eof() -> IoError {
|
|
IoError {
|
|
kind: io::EndOfFile,
|
|
desc: "end of file",
|
|
detail: None,
|
|
}
|
|
}
|
|
|
|
pub fn timeout(desc: &'static str) -> IoError {
|
|
IoError {
|
|
kind: io::TimedOut,
|
|
desc: desc,
|
|
detail: None,
|
|
}
|
|
}
|
|
|
|
pub fn short_write(n: uint, desc: &'static str) -> IoError {
|
|
IoError {
|
|
kind: if n == 0 { io::TimedOut } else { io::ShortWrite(n) },
|
|
desc: desc,
|
|
detail: None,
|
|
}
|
|
}
|
|
|
|
pub fn unimpl() -> IoError {
|
|
IoError {
|
|
kind: io::IoUnavailable,
|
|
desc: "operations not yet supported",
|
|
detail: None,
|
|
}
|
|
}
|
|
|
|
// unix has nonzero values as errors
|
|
pub fn mkerr_libc<T: Int>(ret: T) -> IoResult<()> {
|
|
if ret != Int::zero() {
|
|
Err(last_error())
|
|
} else {
|
|
Ok(())
|
|
}
|
|
}
|
|
|
|
pub fn keep_going(data: &[u8], f: |*const u8, uint| -> i64) -> i64 {
|
|
let origamt = data.len();
|
|
let mut data = data.as_ptr();
|
|
let mut amt = origamt;
|
|
while amt > 0 {
|
|
let ret = retry(|| f(data, amt));
|
|
if ret == 0 {
|
|
break
|
|
} else if ret != -1 {
|
|
amt -= ret as uint;
|
|
data = unsafe { data.offset(ret as int) };
|
|
} else {
|
|
return ret;
|
|
}
|
|
}
|
|
return (origamt - amt) as i64;
|
|
}
|
|
|
|
// traits for extracting representations from
|
|
|
|
pub trait AsFileDesc {
|
|
fn as_fd(&self) -> &fs::FileDesc;
|
|
}
|
|
|
|
pub trait ProcessConfig<K: BytesContainer, V: BytesContainer> {
|
|
fn program(&self) -> &CString;
|
|
fn args(&self) -> &[CString];
|
|
fn env(&self) -> Option<&collections::HashMap<K, V>>;
|
|
fn cwd(&self) -> Option<&CString>;
|
|
fn uid(&self) -> Option<uint>;
|
|
fn gid(&self) -> Option<uint>;
|
|
fn detach(&self) -> bool;
|
|
}
|