163 lines
21 KiB
Plaintext
163 lines
21 KiB
Plaintext
|
!<arch>
|
|||
|
|
/ 0 0 0 0 8 `
|
|||
|
|
// 72 `
|
|||
|
|
pin_project-2ab532b3d4770f62.pin_project.95133998b4771b06-cgu.0.rcgu.o/
|
|||
|
|
lib.rmeta/ 0 0 0 644 21193 `
|
|||
|
|
asm linking ²¥.rmetarust
|
|||
|
|
Q #rustc 1.90.0 (1159e78c4 2025-09-14)Á˜ø½E—y88àìOg[ -a0f3a77406fcd134Á pin_project_internalÁã/M×° !à¾zï€Nw -947c0c4132f8162cÁ ÒµÅL ®Ùp,ØnWš÷*�Ó -eed239b623db52f0Á‡ ˜ UnsafeUnpinÁ __privateÁ
|
|||
|
|
|
|||
|
|
PinnedDropÁ ‘ ª
|
|||
|
|
'aÁ ” ò ó ” PinnedFieldsOfÁ ” PinnedFieldsOfHelperTraitÁ ActualÁ PinnedFieldsOfHelperStructÁ
|
|||
|
|
” ò $” $µ AlwaysUnpinÁ '
|
|||
|
|
'Ð '” 'ò 'ó -” UnsafeDropInPlaceGuardÁ /
|
|||
|
|
/” /ò 3” 3Ô
|
|||
|
|
6” 6‘ UnsafeOverwriteGuardÁ 9” 9ã 9 valueÁ =” =Ô
|
|||
|
|
@” @‘ 8 8 -8 88 B8 ª ò ó õú|¼Û’Ÿ 8” ! #ò …£AÍû¬R ” ÎÞ ' ' (‡ +ò ,ó ?«ZqÍm 8Ì Å / / 0Ä 2ò ÉÁߊ’Zzã„ Å 9 9 — ;ã <À Ùæ<8åžsS„ $ - '6 /@ 9 ÎÞÅ L‡Y / „ šY 5 üÒXH × $ôX „ äX § / 4Ì[ ®
|
|||
|
|
Ô¹[ ”¹[
|
|||
|
|
Þ„ 1 " Ò[ ì[ 8 üâYŠ ôY × LêY ¸ a ®
|
|||
|
|
> ý
|
|||
|
|
„ Äÿ^ µÄ3; �Ï „ üé^0 9 „ ˜_ £_ ? ü§^| ýŒ3T; ±„l � $Ö^ ®
|
|||
|
|
4¹^ „ ,É^ �Ï�Ï ManuallyDropÁ ‘ÏÀ© „ ‰ |éë6<„ Ì ãX À\ š \Æa ®
|
|||
|
|
¼Óa ýÖÙ%C ‹
|
|||
|
|
„ýì�$C êa „b B üá_£ ýËO1; º„\Þa ýžÇåC �„} ý®†ê C ‘„ü»a0 ¸ ó_ � Lé_ ®
|
|||
|
|
Ê „ » ƒ üúL! Ì * ª ò ó õú|¼Û’Ÿ Ì m Ã Ã Ä PhantomDataÁ ±öµ ,±ÀU ¸ § Ì ® µ Ã Ì Þ ê Ÿ õ Þ ü Ì ü¦S0 „ ! % Ø 0 „ 7 > L „ b ! n Ø y „ € ‡ ì€V ' Ì ( ) ' ' (‡ +ò ,ó ?«ZqÍm Ì l Þ s Ã Ã Ä ì ±öµ ,±ÀUÌ Ÿ ¦ ´ ' Ì Ï ( Û Í æ Þ í “ ô û üÍW, / „ 0 % × 0 ®
|
|||
|
|
7 > L / „ b 0 n × y ®
|
|||
|
|
€ ‡ ˜ pin_projectÁ\Ì Ú pinned_dropÁ\† Û ü/Ýa ü/‰ „
|
|||
|
|
<!-- Note: Document from sync-markdown-to-rustdoc:start through sync-markdown-to-rustdoc:end
|
|||
|
|
is synchronized from README.md. Any changes to that range are not preserved. -->
|
|||
|
|
<!-- tidy:sync-markdown-to-rustdoc:start -->
|
|||
|
|
|
|||
|
|
A crate for safe and ergonomic [pin-projection].
|
|||
|
|
|
|||
|
|
## Usage
|
|||
|
|
|
|||
|
|
Add this to your `Cargo.toml`:
|
|||
|
|
|
|||
|
|
```toml
|
|||
|
|
[dependencies]
|
|||
|
|
pin-project = "1"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Examples
|
|||
|
|
|
|||
|
|
[`#[pin_project]`][`pin_project`] attribute creates projection types
|
|||
|
|
covering all the fields of struct or enum.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
use std::pin::Pin;
|
|||
|
|
|
|||
|
|
use pin_project::pin_project;
|
|||
|
|
|
|||
|
|
#[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
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
[*code like this will be generated*][struct-default-expanded]
|
|||
|
|
|
|||
|
|
To use `#[pin_project]` on enums, you need to name the projection type
|
|||
|
|
returned from the method.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
use std::pin::Pin;
|
|||
|
|
|
|||
|
|
use pin_project::pin_project;
|
|||
|
|
|
|||
|
|
#[pin_project(project = EnumProj)]
|
|||
|
|
enum Enum<T, U> {
|
|||
|
|
Pinned(#[pin] T),
|
|||
|
|
Unpinned(U),
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
impl<T, U> Enum<T, U> {
|
|||
|
|
fn method(self: Pin<&mut Self>) {
|
|||
|
|
match self.project() {
|
|||
|
|
EnumProj::Pinned(x) => {
|
|||
|
|
let _: Pin<&mut T> = x;
|
|||
|
|
}
|
|||
|
|
EnumProj::Unpinned(y) => {
|
|||
|
|
let _: &mut U = y;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
[*code like this will be generated*][enum-default-expanded]
|
|||
|
|
|
|||
|
|
See [`#[pin_project]`][`pin_project`] attribute for more details, and
|
|||
|
|
see [examples] directory for more examples and generated code.
|
|||
|
|
|
|||
|
|
## Related Projects
|
|||
|
|
|
|||
|
|
- [pin-project-lite]: A lightweight version of pin-project written with declarative macros.
|
|||
|
|
|
|||
|
|
[enum-default-expanded]: https://github.com/taiki-e/pin-project/blob/HEAD/examples/enum-default-expanded.rs
|
|||
|
|
[examples]: https://github.com/taiki-e/pin-project/blob/HEAD/examples/README.md
|
|||
|
|
[pin-project-lite]: https://github.com/taiki-e/pin-project-lite
|
|||
|
|
[pin-projection]: https://doc.rust-lang.org/std/pin/index.html#projections-and-structural-pinning
|
|||
|
|
[struct-default-expanded]: https://github.com/taiki-e/pin-project/blob/HEAD/examples/struct-default-expanded.rs
|
|||
|
|
|
|||
|
|
<!-- tidy:sync-markdown-to-rustdoc:end -->
|
|||
|
|
Áÿ È Ë ã 8ú $Ì Ð â 8ë
|
|||
|
|
|Ö $ å 8Á $ë ï à 8à $ù ý ® 8 warningsÁ Dþ $ † 8 rust_2018_idiomsÁ „ˆ $ ˜ 8 single_use_lifetimesÁ ¤š $ ¯ 8à ,¹ ¾ Ú 8Ä L¿ $ È 8 unused_variablesÁ „Ê üÅ ˜ƒ
|
|||
|
|
Ìy
|
|||
|
|
Ú ém
|
|||
|
|
Û ³
|
|||
|
|
¶
|
|||
|
|
¹
|
|||
|
|
ü¶! ¦
|
|||
|
|
üð! ‘
|
|||
|
|
ä™- ü”9 6 A trait used for custom implementations of [`Unpin`].Á Î © üÒH E This trait is used in conjunction with the `UnsafeUnpin` argument toÁ ü›8 5 the [`#[pin_project]`][macro@pin_project] attribute.Á Ô © dØ # SafetyÁ å © üé> ; The Rust [`Unpin`] trait is safe to implement - by itself,Á ü¨L I implementing it cannot lead to [undefined behavior][undefined-behavior].Á üõE B Undefined behavior can only occur when other unsafe code is used.Á » © ü¿H E It turns out that using pin projections, which requires unsafe code,Á üˆ O L imposes additional requirements on an [`Unpin`] impl. Normally, all of thisÁ üØ N K unsafety is contained within this crate, ensuring that it's impossible forÁ ü§ D A you to violate any of the guarantees required by pin projection.Á ì © üð I F However, things change if you want to provide a custom [`Unpin`] implÁ üº : 7 for your `#[pin_project]` type. As stated in [the RustÁ üõ P M documentation][pin-projection], you must be sure to only implement [`Unpin`]Á üÆ O L when all of your `#[pin]` fields (i.e. structurally pinned fields) are alsoÁ t– [`Unpin`].Á ¥ © ü© I F To help highlight this unsafety, the `UnsafeUnpin` trait is provided.Á üó O L Implementing this trait is logically equivalent to implementing [`Unpin`] -Á üÃ!O L this crate will generate an [`Unpin`] impl for your type that 'forwards' toÁ ü“"N K your `UnsafeUnpin` impl. However, this trait is `unsafe` - since your typeÁ üâ"K H uses structural pinning (otherwise, you wouldn't be using this crate!),Á ü®#A > you must be sure that your `UnsafeUnpin` impls follows all ofÁ üð#I F the requirements for an [`Unpin`] impl of a structurally-pinned type.Á º$ © ü¾$H E Note that if you specify `#[pin_project(UnsafeUnpin)]`, but do *not*Á ü‡%O L provide an impl of `UnsafeUnpin`, your type will never implement [`Unpin`].Á ü×%L I This is effectively the same thing as adding a [`PhantomPinned`] to yourÁ L¤& type.Á ®& © ü²&E B Since this trait is `unsafe`, impls of it will be detected by theÁ üø&I F `unsafe_code` lint, and by tools like [`cargo geiger`][cargo-geiger].Á Â' © tÆ' # ExamplesÁ Õ' © üÙ'K H An `UnsafeUnpin` impl which, in addition to requiring that structurallyÁ ü¥(B ? pinned fields be [`Unpin`], imposes an additional requirement:Á è( © <ì( ```Á üô(0 - use pin_project::{UnsafeUnpin, pin_project};Á ¥) © ü©) #[pin_project(UnsafeUnpin)]Á ÌÉ) struct Struct<K, V> {Á tã) #[pin]Á œò) field_1: K,Á œ†* field_2: V,Á ,š* }Á * © ü¤*L I unsafe impl<K, V> UnsafeUnpin for Struct<K, V> where K: Unpin + Clone {}Á <ñ* ¸> ù* © üý*2 / [`PhantomPinned`]: core::marker::PhantomPinnedÁ ü°+D A [cargo-geiger]: https://github.com/rust-secure-code/cargo-geigerÁ üõ+B ? [pin-projection]: core::pin#projections-and-structural-pinningÁ ü¸,` ] [undefined-behavior]: https://doc.rust-lang.org/reference/behavior-considered-undefined.htmlÁ \ª- “Þ ü™- Œ„. ÿ Ï- Ò- Ù- 8† 4Ó- tÍ- LŒ. !'(/09— d«. �Ï ì\ñ. Ã
|
|||
|
|
ì Ä
|
|||
|
|
|
|||
|
|
PhantomPinnedÁlþ. ÏÞ ˆE ÐÞ UnpinÁ,�/ ÎÞ DropÁ$¢/ Å
|
|||
|
|
PinÁ µ/ ±¸ § Â/ ¢ __PinProjectInternalDeriveÁÔ„0 Ü ß\°0 ¼ . øüØ.t íïÂÄ�ŸL�/ �D°/ �qsüî/0 O”©0 C¤ü8 ÿ ë8 î8 õ8 8† 4ï8 té8 T†9 òDüü8a ü²9% ÿ �9 9 §9 8† 4¡9 t›9 $¼9 C±¸±¸ åE ³¸÷ ÀR $ ÂÄ%^PòàÞ CúD¸ Ë9
|
|||
|
|
úD$Á9 mÿ ÑL ÔL ÛL 8† 4ÕL tÏL <…M Ð ” “ÞÌ ‘M ª ò ó õú|¼Û’Ÿ ÐÌ õú|¼Û’Ÿ Ã Ã Ä ì ±öµ ,±ÀU и ÌçJ mÇ ¿KÌçJ
|
|||
|
|
ÐÌ�M ×Ù œœM ¿K ±M ÌüäMC 8 D ” D ØJ ðM Ì \üM ‘ ÔßP ÿ ÎP ÑP ØP 8† 4ÒP tÌP tèP ” ’Þ„ ÷P Ø üÆR# ÿ µR ¸R ¿R 8† 4¹R t³R ÌÐR òDüÆRH “Þ úD ¤ôR ‡O œôR 4ùR ‡ÿ •S ˜S ŸS 8† 4™S t“S Ô±S ” " " “Þ„ ÌS Ø …£AÍû¬R ! # „Ø ‡P „Ø
|
|||
|
|
!„]_ ×S „üßSK ” % % þO äS Ø&
|
|||
|
|
\µT 4ºT $ $ „ ÿ ïU òU ùU 8† 4óU tíU \‹V Ð ) ” * * ) ’ÞÌ ›V ' ' (‡ +ò ,ó ?«ZqÍm ÐÌ ?«ZqÍm ( +, ¿K“¶R › ¿K“¶R ' '
|
|||
|
|
( ÐÌ—V « œžV ' ' ¿Kt³V ' ' “üÈV$ 8 E ” . E . §R ÍV ’ %
|
|||
|
|
ÿ ¼W ¿W ÆW 8† 4ÀW tºW ´ØW ” 1 1 þO ïW × ÉÁߊ’Zzã 0 2 ®
|
|||
|
|
× 8%
|
|||
|
|
I ®
|
|||
|
|
× / /
|
|||
|
|
0„_a 4úW / / ®
|
|||
|
|
ü‡X) ” 4 4 þO ŒX ×5
|
|||
|
|
üÒX& ÿ ½X ÀX ÇX 8† 4ÁX t»X àX ®
|
|||
|
|
× 3 3
|
|||
|
|
5„§ ³ü¥Y2 ” 7 7 þO ªY ×8 8
|
|||
|
|
”âY $åY F F׸ 6 êY 6
|
|||
|
|
8„$ïY üÿ\" ÿ î\ ñ\ ø\ 8† 4ò\ tì\ ¤Š] ” : : ƒN Ÿ] � Ùæ<8åžsS ;< B t¬] 4¬] 9 9 ®
|
|||
|
|
´Ä] ,Ä] 9 9 ‹
|
|||
|
|
üæ] ” > > ƒN ë] � ?
|
|||
|
|
ü§^3 ÿ ’^ •^ œ^ 8† 4–^ t�^ µ^ ®
|
|||
|
|
„� = =
|
|||
|
|
?„ãüÀü®_( ” A A ƒN ³_ � B B
|
|||
|
|
”á_ $ä_ G G� ¸ @ é_ @
|
|||
|
|
B„$î_ ¡N æV ó+3=BÌ Ú +https://github.com/taiki-e/pin-project-liteÁ ¹E undefined behaviorÁ #[pin_project]Á code like this will be generatedÁ Thttps://github.com/taiki-e/pin-project/blob/HEAD/examples/struct-default-expanded.rsÁ core::marker::PhantomPinnedÁ core::markerÁ cargo geigerÁ pin-project-liteÁ Ì ±[ ¹E ˆE ,https://doc.rust-lang.org/std/pin/index.htmlÁ ý[ �\ core::pinÁ Ž] ®] � Chttps://github.com/taiki-e/pin-project/blob/HEAD/examples/README.mdÁ Ð] Ì ±[ ¹E ÎÞˆE pin-projectionÁ ù] ý[ the RustdocumentationÁ ´^ Ž] ÏÞ examplesÁ Ñ^ Ð] ˆE ¸_ ù] Fhttps://doc.rust-lang.org/reference/behavior-considered-undefined.htmlÁ Õ_ ´^ ÀR˜ Rhttps://github.com/taiki-e/pin-project/blob/HEAD/examples/enum-default-expanded.rsÁ ÿ_ Ñ^ 0https://github.com/rust-secure-code/cargo-geigerÁ ¸_ æ[ ¥` Õ_ ˜ µ\ „a ÿ_ ¿] åa æ[ ¥` ˜ �\ µ\ „a ®] ¿] åa êGª¦¸ ¾ ’ÌìÇò�š£ îÅ É Ì Ï — š Ÿ ˆH¿H÷GîGóH‘Þ’ÞÎÞ w´˜9•ð"æ!Z…P…ýë»*tá%ê¢H�d5ÂuÙ?-—ü?Úý^…-œNÕöc‚‰Ò:>ß芓ÂC�œ³ é.�šcG3âI«ˆÆ€ížãÕÉ•¢¡ì®Mar. “0Ú�O£±žÏo Ai.H©fnI3h0=ò›PÍ@PzâÄàò‘ÉÌâ :öXµ¾q¡î+ëZ12¹¡×m¤•_ò.YàÄè´½ 65ôÚl¥Ï…û11kr U…åÔ|ÅtŒÏÀÇkú?ÝóÀEÇéä“Õ·Ëð? ¡]&Ó¬
|
|||
|
|
üë:µ/ÊÜ¡ƒ
|
|||
|
|
š¡žÆl‘vˆDW[1Ì;ŒsRܯLNs“—+Jøàå÷2Câ²üùÚwðÚ|SÊÊ®q+O‰-—¥øWP Wpmëþ©9Æümy ŠmîE=§ áN åÑŠa/G ë…FG‹èª„™·Ö¦%ÿF>>›®tî\¢ÞB}7”s 蘆ë÷B8,hOµb©Jˆ·pzmÈ@$íìWܨiÿÈî]‚»å ´Ãr¶r•±ý—96¦7‡tvSû:ÆÀ½%T®X@·ËºãWŠ%ØOÖcOfö¸>2틦è‹)&‘Ç•×ò9”‘‡~¦"Ëš|K“(u ~cY”R\Zà9Îßú±.¥_?STþ‡‰cÉï}E^¾Wü‡Z‚\>} @̆gÑ×#g¸c}ã’=Ç9ý|:³ZÜ‘½[â`Í3ʯQNNêìUá”4À ' ' ¢- £-> Q "
|
|||
|
|
Ž<" ‚#å#ˆ$ Ë %á %ø % B& ¬&& ':' ÷ ' ( A (W( n )„ )› ) Ö) Œ *£ * ×*< + r +Á+ 6 ,N ,g , ›, - ? -< "E " Ú# ' " Û# ;% 0 & ' ¥' .(
|
|||
|
|
) Å ) 8* Ã* \+ !, ‡, )-%
|
|||
|
|
%
|
|||
|
|
% % ; Ü!D" ®# $´$Š% Í%ã% l& Ø&*'f'Å' ù' E(ƒ(-) p)†) *Z* Ž* + ‡+í+ :,R, Ö, T- qwz‚Š"H#N#S#U#Y#]#a#g#m#q#x#~#à#…$t%´%º%Ç%Ý%ó%1&>&š&§&"'7'¯'æ'ó' (0(=(T()W)])j)€)–)Æ)Ó)D*{*ˆ*ž*Å*Ò*7+a+n+¼+%,2,J,b,‰,–,-.-;-‰-�-“-™-ž- t ‡Ø!@"L# W#[#_#e#k#o#v#|#ª# $°$w%¸%¼%Ë%á% 3&h&œ&Ô&&'b'²'è'÷' 2(A(()[)_)n)„) È)þ)G*}*Œ* Ç*ý* c+r+é+',6,N, ‹,Á, 0-?-Œ-‘-—-œ- - ï! Á#s$Õ$¡% Ä%×%í%&;&€&¤&ë&3'{'Ù'ð'(#(:(N(¤(D) g)z)�)º)Ð)*n*…*˜*¸*Ï*%+Q+k+ª+,/,D,\,|,“,ë, -8-w- Ý! ¯#g$·$™% ¾%Ï%å%ú%5&m&ž&Ù&+'h'Ñ'ê'û'(4(F(†(<) a)r)ˆ)�)Ê)*f**�*¥*É* +>+e+ž+ï+),<,T,i,�,ã, -2-k- w$ç$§% Û%ñ%.& ’& �'ß' (,( R(¶(J) ~)”)Ã) *t* œ*Á* )+Z+ ®+ , H,`,…, ï,'- {- !$µ$Œ% g'Ç' „(/) *\* + ˆ+î+ ×, U- "$=%Ž% ¦'È' )1) 9*]* + ‰+ Ø, V- $ y% ´' ) I* + v+ Å, C-
|
|||
|
|
T Œ Ò Æ% =& ¦& ò' <( i) Ò) ‡* Ñ* m+ 1, •, :- k … #
|
|||
|
|
q Ö | x . Ñ Î o
|
|||
|
|
- Ð Í n
|
|||
|
|
Ô z v i „ "
|
|||
|
|
·
|
|||
|
|
Õ { w j ¥% Ý' H) r* ~$ 0+ µ+ ö, ‚- B* #, " Ë# õ& F F9 Ö!>" ¨# ®$ ø% Ò& `' ( }( ›) ü) £* <+ ç+ g, - 1% ›' ) .* , %% �' ô( "*
|
|||
|
|
,Å È Ï Ó × Û í ý
|
|||
|
|
!%):AHLU\cjnuŠ‘±¾ßãêñõü '.59@]ahosz�…Œ“®µ¼ÈÌÓÚÞåìòøþ 4% ž' ) 1* , ¸
|