// Copyright 2015 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 or the MIT license // , at your // option. This file may not be copied, modified, or distributed // except according to those terms. use cell::Cell; use ptr; use sync::Arc; use sys_common; use sys_common::mutex::Mutex; pub struct Lazy { // We never call `lock.init()`, so it is UB to attempt to acquire this mutex reentrantly! lock: Mutex, ptr: Cell<*mut Arc>, init: fn() -> Arc, } #[inline] const fn done() -> *mut Arc { 1_usize as *mut _ } unsafe impl Sync for Lazy {} impl Lazy { /// Safety: `init` must not call `get` on the variable that is being /// initialized. pub const unsafe fn new(init: fn() -> Arc) -> Lazy { Lazy { lock: Mutex::new(), ptr: Cell::new(ptr::null_mut()), init, } } pub fn get(&'static self) -> Option> { unsafe { let _guard = self.lock.lock(); let ptr = self.ptr.get(); if ptr.is_null() { Some(self.init()) } else if ptr == done() { None } else { Some((*ptr).clone()) } } } // Must only be called with `lock` held unsafe fn init(&'static self) -> Arc { // If we successfully register an at exit handler, then we cache the // `Arc` allocation in our own internal box (it will get deallocated by // the at exit handler). Otherwise we just return the freshly allocated // `Arc`. let registered = sys_common::at_exit(move || { let ptr = { let _guard = self.lock.lock(); self.ptr.replace(done()) }; drop(Box::from_raw(ptr)) }); // This could reentrantly call `init` again, which is a problem // because our `lock` allows reentrancy! // That's why `new` is unsafe and requires the caller to ensure no reentrancy happens. let ret = (self.init)(); if registered.is_ok() { self.ptr.set(Box::into_raw(Box::new(ret.clone()))); } ret } }