| tag | 599159c566ddb2729e4c05349cc677fef97ac7ff | |
|---|---|---|
| tagger | The Android Open Source Project <initial-contribution@android.com> | Wed May 11 05:15:14 2022 +0000 |
| object | 73d5d1b098e3449ff2b6bd7fce807217aba158d5 |
Android mainline 12.0.0 release 94
| commit | 73d5d1b098e3449ff2b6bd7fce807217aba158d5 | [log] [tgz] |
|---|---|---|
| author | Luke Huang <huangluke@google.com> | Wed May 12 11:36:31 2021 +0000 |
| committer | Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com> | Wed May 12 11:36:31 2021 +0000 |
| tree | d6a3b347e26f065a3b2bdd0d9c2627e287f35fba | |
| parent | e92da38313774d6d6a5cf3387568d6412bb43636 [diff] | |
| parent | cfe1b4ab825d388b01d622833c960bf6f3ebcb4b [diff] |
Make libpin_project_lite available to DnsResolver am: 0cc9975fc2 am: 48a3fef7ff am: 975d2aab54 am: cfe1b4ab82 Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/pin-project-lite/+/1705106 Change-Id: I9ed615524c0d0218d6d47bc2a7d9d66dace88487
A lightweight version of pin-project written with declarative macros.
Add this to your Cargo.toml:
[dependencies] pin-project-lite = "0.2"
Compiler support: requires rustc 1.37+
pin_project! macro creates a projection type covering all the fields of struct.
use pin_project_lite::pin_project; use std::pin::Pin; pin_project! { struct Struct<T, U> { #[pin] pinned: T, unpinned: U, } } impl<T, U> Struct<T, U> { fn method(self: Pin<&mut Self>) { let this = self.project(); let _: Pin<&mut T> = this.pinned; // Pinned reference to the field let _: &mut U = this.unpinned; // Normal reference to the field } }
To use pin_project! on enums, you need to name the projection type returned from the method.
use pin_project_lite::pin_project; use std::pin::Pin; pin_project! { #[project = EnumProj] enum Enum<T, U> { Variant { #[pin] pinned: T, unpinned: U }, } } impl<T, U> Enum<T, U> { fn method(self: Pin<&mut Self>) { match self.project() { EnumProj::Variant { pinned, unpinned } => { let _: Pin<&mut T> = pinned; let _: &mut U = unpinned; } } } }
Here are some similarities and differences compared to pin-project.
pin-project-lite guarantees safety in much the same way as pin-project. Both are completely safe unless you write other unsafe code.
This library does not tackle as expansive of a range of use cases as pin-project does. If your use case is not already covered, please use pin-project.
This is the only reason to use this crate. However, if you already have proc-macro related dependencies in your crate's dependency graph, there is no benefit from using this crate. (Note: There is almost no difference in the amount of code generated between pin-project and pin-project-lite.)
This macro does not handle any invalid input. So error messages are not to be useful in most cases. If you do need useful error messages, then upon error you can pass the same input to pin-project to receive a helpful description of the compile error.
pin-project supports this by #[pinned_drop].
pin-project supports this by UnsafeUnpin and !Unpin.
pin-project supports this.
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
