Struct Extender

pub struct Extender<'scope, 'env> { /* private fields */ }

Implementations

impl<'scope, 'env> Extender<'scope, 'env>

pub fn fn_once<'extended, P, I, O>( &'scope self, f: P, ) -> impl FnOnce(I) -> O + Send + Sync + 'extended

where P: PointerIntoInner + Send, P::Pointee: FnOnce(I) -> O, I: Send + 'extended, O: Send + 'extended, 'extended: 'scope,

pub fn fn_mut<'extended, P, I, O>( &'scope self, f: P, ) -> impl FnMut(I) -> O + Send + Sync + 'extended

where P: PointerDerefMut + Send, P::Pointee: FnMut(I) -> O, I: Send + 'extended, O: Send + 'extended, 'extended: 'scope,

Examples found in repository

examples/references.rs (line 25)

fn main() {
    let mut a = vec![1, 2, 3];
    let mut x = 0;

    let f1 = &|()| {
        println!("hello from the first scoped thread");
        // We can borrow `a` here.
        dbg!(&a);
    };
    let f2 = &mut |()| {
        println!("hello from the second scoped thread");
        // We can even mutably borrow `x` here,
        // because no other threads are using it.
        x += a[0] + a[2];
    };

    scope_lock::lock_scope(|e| {
        thread::spawn({
            let f = e.fn_(f1);
            move || f(())
        });
        thread::spawn({
            let mut f = e.fn_mut(f2);
            move || f(())
        });
        println!("hello from the main thread");
    });

    // After the scope, we can modify and access our variables again:
    a.push(4);
    assert_eq!(x, a.len());
}

examples/boxed.rs (lines 17-22)

fn main() {
    let mut a = vec![1, 2, 3];
    let mut x = 0;

    scope_lock::lock_scope(|e| {
        thread::spawn({
            let f = e.fn_(Box::new(|()| {
                println!("hello from the first scoped thread");
                // We can borrow `a` here.
                dbg!(&a);
            }));
            move || f(())
        });
        thread::spawn({
            let mut f = e.fn_mut(Box::new(|()| {
                println!("hello from the second scoped thread");
                // We can even mutably borrow `x` here,
                // because no other threads are using it.
                x += a[0] + a[2];
            }));
            move || f(())
        });
        println!("hello from the main thread");
    });

    // After the scope, we can modify and access our variables again:
    a.push(4);
    assert_eq!(x, a.len());
}

examples/ref_once.rs (lines 24-32)

fn main() {
    let mut a = vec![1, 2, 3];
    let mut x = 0;

    let mut slots = (MaybeUninit::uninit(), MaybeUninit::uninit());

    scope_lock::lock_scope(|e| {
        thread::spawn({
            let f = e.fn_(RefOnce::new(
                |()| {
                    println!("hello from the first scoped thread");
                    // We can borrow `a` here.
                    dbg!(&a);
                },
                &mut slots.0,
            ));
            move || f(())
        });
        thread::spawn({
            let mut f = e.fn_mut(RefOnce::new(
                |()| {
                    println!("hello from the second scoped thread");
                    // We can even mutably borrow `x` here,
                    // because no other threads are using it.
                    x += a[0] + a[2];
                },
                &mut slots.1,
            ));
            move || f(())
        });
        println!("hello from the main thread");
    });

    // After the scope, we can modify and access our variables again:
    a.push(4);
    assert_eq!(x, a.len());
}

pub fn fn_<'extended, P, I, O>( &'scope self, f: P, ) -> impl Fn(I) -> O + Send + Sync + 'extended

where P: PointerDeref + Send, P::Pointee: Fn(I) -> O + Sync, I: Send + 'extended, O: Send + 'extended, 'extended: 'scope,

Examples found in repository

examples/references.rs (line 21)

fn main() {
    let mut a = vec![1, 2, 3];
    let mut x = 0;

    let f1 = &|()| {
        println!("hello from the first scoped thread");
        // We can borrow `a` here.
        dbg!(&a);
    };
    let f2 = &mut |()| {
        println!("hello from the second scoped thread");
        // We can even mutably borrow `x` here,
        // because no other threads are using it.
        x += a[0] + a[2];
    };

    scope_lock::lock_scope(|e| {
        thread::spawn({
            let f = e.fn_(f1);
            move || f(())
        });
        thread::spawn({
            let mut f = e.fn_mut(f2);
            move || f(())
        });
        println!("hello from the main thread");
    });

    // After the scope, we can modify and access our variables again:
    a.push(4);
    assert_eq!(x, a.len());
}

examples/boxed.rs (lines 9-13)

fn main() {
    let mut a = vec![1, 2, 3];
    let mut x = 0;

    scope_lock::lock_scope(|e| {
        thread::spawn({
            let f = e.fn_(Box::new(|()| {
                println!("hello from the first scoped thread");
                // We can borrow `a` here.
                dbg!(&a);
            }));
            move || f(())
        });
        thread::spawn({
            let mut f = e.fn_mut(Box::new(|()| {
                println!("hello from the second scoped thread");
                // We can even mutably borrow `x` here,
                // because no other threads are using it.
                x += a[0] + a[2];
            }));
            move || f(())
        });
        println!("hello from the main thread");
    });

    // After the scope, we can modify and access our variables again:
    a.push(4);
    assert_eq!(x, a.len());
}

examples/ref_once.rs (lines 13-20)

fn main() {
    let mut a = vec![1, 2, 3];
    let mut x = 0;

    let mut slots = (MaybeUninit::uninit(), MaybeUninit::uninit());

    scope_lock::lock_scope(|e| {
        thread::spawn({
            let f = e.fn_(RefOnce::new(
                |()| {
                    println!("hello from the first scoped thread");
                    // We can borrow `a` here.
                    dbg!(&a);
                },
                &mut slots.0,
            ));
            move || f(())
        });
        thread::spawn({
            let mut f = e.fn_mut(RefOnce::new(
                |()| {
                    println!("hello from the second scoped thread");
                    // We can even mutably borrow `x` here,
                    // because no other threads are using it.
                    x += a[0] + a[2];
                },
                &mut slots.1,
            ));
            move || f(())
        });
        println!("hello from the main thread");
    });

    // After the scope, we can modify and access our variables again:
    a.push(4);
    assert_eq!(x, a.len());
}

pub fn fn_unsync<'extended, P, I, O>( &'scope self, f: P, ) -> impl Fn(I) -> O + Send + 'extended

where P: PointerDeref + Send, P::Pointee: Fn(I) -> O, I: Send + 'extended, O: Send + 'extended, 'extended: 'scope,

impl<'scope, 'env> Extender<'scope, 'env>

pub fn future<'extended, P, O>( &'scope self, f: P, ) -> impl Future<Output = O> + Send + Sync + 'extended

where P: PointerPinUnforgotten + Send + 'scope, P::Pointee: Future<Output = O>, O: Send + 'extended, 'extended: 'scope,