captur

Crates.iocaptur
lib.rscaptur
version0.1.0
sourcesrc
created_at2021-07-01 05:50:56.394918
updated_at2021-07-01 05:50:56.394918
descriptionMacro to capture whole structs from disjoint fields in a closure.
homepage
repositoryhttps://github.com/MitMaro/captur
max_upload_size
id417346
size7,119
Tim Oram (MitMaro)

documentation

https://docs.rs/captur/

README

Crates.io docs GitHub license

Captur

Starting in Rust 2021, Rust will no longer capture whole structs and instead will only capture a disjoint set of the fields used in a closure. In some cases, it is necessary to capture the structs to retain a particular drop order. This macro will capture the struct within the closure, ensuring the correct drop order.

The Fix

The typical fix to this problem is to create an unused reference to the struct.

let some_struct = SomeStruct::new();
let result = || {
    // capture some_struct within the closure
    let _ = &some_struct;
    println!("{}", some_struct.y);
}

While this is trivial to implement in closures where capturing is required, without a comment it, the meaning of the unused line is difficult to determine. This macro provides a self documenting and potentially more concise way to capture the structs.

Installation and Usage

[dependencies]
captur = "0.1"
use captur::capture;

fn send_event_and_action(action: &Action, event: Event) {
    send(|sender| {
        capture!(action, event);
        sender.send(action.name.as_str(), event.code);
    });
}

License

Captur is released under the ISC license. See LICENSE.

Commit count: 3

cargo fmt