Crates.io | tenacious |
lib.rs | tenacious |
version | 0.2.3 |
source | src |
created_at | 2015-05-09 09:54:24.150828 |
updated_at | 2016-08-18 12:41:56.094183 |
description | [RETIRED: Will not work with MIR] A plugin to prevent certain types from being moved |
homepage | |
repository | https://github.com/Manishearth/rust-tenacious |
max_upload_size | |
id | 2063 |
size | 11,872 |
This plugin warns when types marked #[no_move]
are being moved.
This is quite useful for ensuring that things don't get moved around when data is shared via an FFI. Servo uses this for safely sharing rooted values with the spidermonkey GC.
Note that #[no_move]
is transitive, any struct or enum containing a #[no_move]
type
must be annotated as well. Similarly, any type with #[no_move]
substitutions in its type parameters
(E.g. Vec<Foo>
where Foo
is no_move
) will be treated as immovable.
Example:
#![plugin(tenacious)]
#![feature(custom_attribute, plugin)]
#[no_move]
#[derive(Debug)]
struct Foo;
fn main() {
let x = Foo;
let y = x; // warning
bar(Some(y)); // warning
}
fn bar(t: Option<Foo>) {
match t {
Some(foo) => { // warning
println!("{:?}", foo)
},
_ => ()
}
}
struct MoreFoo {
foos: Vec<Foo> // warning
}
#[no_move]
struct MoreFoo2 {
foos: Vec<Foo> // no warning
}
Note that this will not lint on the moving of temporaries (though it's easy to tweak it to do so). For example, if foo()
returns a move-protected value, bar(foo())
will not error even though let x = foo(); bar(x)
will, since the value returned by foo()
is a temporary (rvalue) and doesn't actualy get moved in memory.
It also will not catch moves within generic functions like mem::swap()
and `mem::replace()``
Adding the #[allow(moved_no_move)]
annotation to a struct will suppress warnings
that the struct contains a #[no_move]
type but is not marked as #[no_move]
.
The #[allow_movable_interior]
attribute does the above and additionally permits
moveable types in type parameters. See tests/run-pass/allow-move.rs
for examples.
Be aware that if you depend on a crate using #[no_move]
, you must have #![plugin(tenacious)]
in your own crate to see the warnings.