54 lines
9.4 KiB
Plaintext
54 lines
9.4 KiB
Plaintext
|
rust
|
|||
|
|
õ# #rustc 1.93.0 (254b59607 2026-01-19)Á³VOÐêùÿ²?ÑL¼�§Ì± -a7a40eb546f9e2b0Á ë&Gf·Ã ¬ëñq:¤»b -bb76018b1173caf6Á‰ ³
|
|||
|
|
core_reexportÁ stack_pinÁ pin_mutÁ
|
|||
|
|
projectionÁ ï unsafe_unpinnedÁ ³ Â<† ïlÐ è|¨ ü Å Ì Utilities for pinningÁ¡ • ˜ Ê 8¹ l™ § 7 https://docs.rs/pin-utils/0.1.0Á ü©!ü’: ³Â  ïÀ è¾ öøú¬Ý¡ Ð Ó Ú 8° 4Ô tÎ lå â =¡>‡ assert_matchesÁu‰@‡ © ï%�B‡ ÖEÒD‡ ¯ ¦MŸF‡ ³ ¨%ŒL‡ Ð ÿ ±L‡ Á „ ÕL‡ ´ – ùL‡ · numÁ ”M‡ ¼ ²%ÏM‡ ² � UÝM‡ Ê memÁ ñM‡ Õ profilingÁM¾N‡ ã ÷ ÑN‡ ê ÄM‘O‡ ™ borrowÁ5ÁO‡ ¥ È-ÑO‡ » Ð àO‡ ‘ ª=íO‡ Ò >=þO‡  errorÁ-�P‡ È ö-žP‡ Þ ‡
|
|||
|
|
5P‡ Ñ Þ ½P‡ Á ÷ ÷P‡ ã# ƒ-„Q‡ ¨$ asciiÁ-“Q‡ ™) šM¢Q‡ æ)
|
|||
|
|
async_iterÁUîQ‡ “* bstrÁ%²R‡ Ë* cellÁ%ÀR‡ ¸+ À%ÎR‡ Ž/ º ÜR‡ †1 ioÁ©S‡ ²2 £ %µS‡ î2 netÁ ÃS‡ öN ä 5ÐS‡ íQ osÁàS‡ ïS õ -ìS‡ …T ¡ MûS‡ ©U § ÌT‡ ÑU ¸ ÙT‡ ëU randomÁ5˜U‡ ›W rangeÁ-áU‡ ¬W Û
|
|||
|
|
5ðU‡ �Y Â%€V‡ ÒZ
|
|||
|
|
unsafe_binderÁmÈV‡ ¾] Í àV‡ Á] ¢%íV‡ ‡b î-ûV‡ ªc œ ŠW‡ ›s timeÁ%—W‡ »z wtf8Á%¦W‡ «{ unicodeÁ=µW‡ ”| „5ÓW‡ »| taskÁ%ãW‡ Ó} á-«X‡ þ~ primitiveÁMÃY‡ Å€ archÁ%ú^‡ Ñ‚ —%ðc‡ ŽŒ õ -ç t ’M›
|
|||
|
|
u assert_neÁM¨ v debug_assertÁeþS y debug_assert_eqÁ}æ[ z debug_assert_neÁ}Ùc { matchesÁ=‰} } 6-Ä‘ ~ writeÁ-¦ª writelnÁ=þ± € ß]¹Á �
|
|||
|
|
unimplementedÁmöÖ ‚ todoÁ%ÿè ƒ émËø … â]”‘ † ˆ�ã• ‡ åu—š ˆ Ò ´¦ ‰ å UŽ² Š ðe•¹ ‹ ï5œ¿ Œ È %óÆ � ä5‘Ò Ž À%�à � µM„æ � ó]ð ‘ ñmùú ’ é
|
|||
|
|
]€ “ ¢ °‰ ” ð=ž¢ • ‘5Õí ˜ å U„ñ ™ õeŸô š ²UøF‡ x ¼ËI‡ �Œ  ÏI‡ ”Œ È ÔI‡ —Œ Î ÙI‡ šŒ ˜ -ÞI‡ Œ ¦åI‡ ¯Œ ¬ éI‡ ¦Œ ² îI‡ ©Œ ¸ óI‡ ¬Œ ‰-øI‡ ²Œ Ô%ÞK‡ ‘Œ ¾%äK‡ £Œ assert_unsafe_preconditionÁÕºH � impl_partial_eqÁ}¿‡ Þ* impl_partial_eq_ordÁ�é‡ à* impl_partial_eq_nÁ�€‡ â* ° e³À ÙU $�lš Lž ¤ù ô Pins a value on the stack.Á Ë l#
|
|||
|
|
# ExampleÁ 1 Ë \5 ```rustÁ ìA # use pin_utils::pin_mut;Á Ì_ # use core::pin::Pin;Á œy # struct Foo {}Á ü� let foo = Foo { /* ... */ };Á ”® pin_mut!(foo);Á üÁ let _: Pin<&mut Foo> = foo;Á <á ```Á &|é Ž ÷ ” ¨ , • – Ÿ , — 8 xÁ ˜ & ™ 8Û ,š $
|
|||
|
|
¡ , £ ¤ ¦ $ ¥ - § *ª õ , ¯ ° ò 8 ï 8 ó , ÷ 8Ë ø ú , ü 8Ë ý % þ + ì í ÿ 8è ,î ó þ 8
|
|||
|
|
unused_mutÁ Tô 8 ‰ 8 � , ‘ 8Ë ’ ” 8" 4– � ë , « 8 ,¬ '± 8š l³ 'À 8¸ Â 'Å 8 PinÁ Ç 'Ê 8 lÌ Ù á Ú 8 Û , ß 8Ë à % ì
|
|||
|
|
ó t¶ Tº Ôà ü * ' A pinned projection of a struct field.Á +Ë d/ # SafetyÁ <Ë ü@C @ To make using this macro safe, three things need to be ensured:Á ü„N K - If the struct implements [`Drop`], the [`drop`] method is not allowed toÁ üÓ" move the value of the field.Á üöP M - If the struct wants to implement [`Unpin`], it has to do so conditionally:Á üÇO L The struct can only implement [`Unpin`] if the field's type is [`Unpin`].Á ü—/ , - The struct must not be `#[repr(packed)]`.Á ÇË lË‹ ÙË \Ý© üé! use pin_utils::unsafe_pinned;Á Ü‹ use std::marker::Unpin;Á ´§ use std::pin::Pin;Á ¾Ë œÂ struct Foo<T> {Á ŒÖ field: T,Á ,è }Á îË ¤ò impl<T> Foo<T> {Á ü‡! unsafe_pinned!(field: T);Á ©Ë ü* ' fn baz(mut self: Pin<&mut Self>) {Á üØO L let _: Pin<&mut T> = self.field(); // Pinned reference to the fieldÁ L¨ }Á ,²¡$ ¸Ë ü¼@ = impl<T: Unpin> Unpin for Foo<T> {} // Conditional Unpin implÁ <ý… …Ë ü‰J G Note: borrowing the field multiple times requires using `.as_mut()` toÁ ôÔ avoid consuming the `Pin`.Á óË ü÷" [`Unpin`]: core::marker::UnpinÁ Äš [`drop`]: Drop::dropÁ &|³ Þ Û ä ñ , å 8þ æ & ç 8� è & ê , ì 8 tÁ í & î 8” ï *ó ö Ù + € � ” 8è ,‚ ‡ “ 8 unsafe_codeÁ \ˆ 8 ž , ¡ 8þ ¢ £ : '__aÁ $¤ ¨ © õ 8 $· & » , ½ 8 ,¾ 'à 8š lÅ 'Ò 8¸ Ô '× 8È Ù Ü Ý :Ï* $Þ 8 ã 8 $ç ë (÷ , ú 8 ,û '€
|
|||
|
|
8š l‚
|
|||
|
|
'�
|
|||
|
|
8¸ ‘
|
|||
|
|
'”
|
|||
|
|
8È –
|
|||
|
|
™
|
|||
|
|
š
|
|||
|
|
:Ï* $›
|
|||
|
|
8
|
|||
|
|
, ¤
|
|||
|
|
8¸) ¥
|
|||
|
|
¦
|
|||
|
|
¨
|
|||
|
|
Ó 8" 4¶
|
|||
|
|
½
|
|||
|
|
É , Ï
|
|||
|
|
8 ,Ð
|
|||
|
|
'Õ
|
|||
|
|
8š l×
|
|||
|
|
'ä
|
|||
|
|
8¸ æ
|
|||
|
|
'é
|
|||
|
|
8È ë
|
|||
|
|
'î
|
|||
|
|
8 map_unchecked_mutÁ Œð
|
|||
|
|
� » 8 $— $ › � 8Ë ž Ÿ ¡ 8 ¢ 8Ë ¦ § , ¨ 8þ © ä› üÞ - * An unpinned projection of a struct field.Á Œ Ë d� ÷ � Ë ü¡ J G This macro is unsafe because it creates a method that returns a normalÁ üì O L non-pin reference to the struct field. It is up to the programmer to ensureÁ ü¼
|
|||
|
|
H E that the contained value can be considered not pinned in the currentÁ d… context.Á ’Ë l–‹ ¤Ë \¨© ü´# use pin_utils::unsafe_unpinned;Á ´ØÄ# ïË |ó struct Bar;Á „ƒ
|
|||
|
|
struct Foo {Á œ” field: Bar,Á ,¨¡$ ®Ë t² impl Foo {Á üÁ% " unsafe_unpinned!(field: Bar);Á çË üë*‹% ü–L I let _: &mut Bar = self.field(); // Normal reference to the fieldÁ Lã•& ,í¡$ <ó… ûË üÿJœ' üÊ avoid consuming the [`Pin`].Á ëË Üï [`Pin`]: core::pin::PinÁ &|‹ . ¸ ç ¾ Ë , ¿ 8þ À & Á 8�  & Ä , Æ 8¸) Ç & È 8” É *Í Ð å + Ú Û î 8è ,Ü á í 8–* \â 8 ø , û 8þ ü ý :Ï* $þ ‚ ƒ Ï 8 $‘ & • , — 8 ,˜ '� 8š lŸ '¬ 8¸ ® '± 8È ³ ¶ · :Ï* $¸ 8 ½ 8 $Á Å (Ñ Ô :Ï* $Õ 8 Ú , Þ 8¸) ß á ß 8" 4ï ö Õ ˆ 8 ‰ , � 8 ,Ž '“ 8š l• '¢ 8¸ ¤ '§ 8È © '¬ 8 get_unchecked_mutÁ Œ® ¿ Ä 8 $À Å , Æ 8þ Ç UnpinÁ
|
|||
|
|
Drop::dropÁ ³ core::pin::PinÁ ² µ core::marker::UnpinÁ DropÁ � core::markerÁ core::pinÁ È ‡; åâ³ ¥; ˜²‘; ² Â; åâè; Ñ Ú; ù; È ‡; ‘; � ³ ¥; ² Â; Ú; è; ù; ëUÈ þ „ ޣÞÉôñú÷Ä� “ – ™ Þ á æ òJ©K·J®JÞK¨â©âåâ ™Ct©¬8¤Ã›�ê´T¸ ÷³Ôš]ìyÒ|[óìz'gP¬F� /3&j�IÝõ¸¯¢¡†®` ÝÎIJoIÌÓ<O˾G�+È`d� >„ì¿ -p? È Ô
|
|||
|
|
' 3'ƒ"¼ - Ð / )))» , Î
|
|||
|
|
-k:öúüÀ Ä Ð #/ ø ( Ê
|
|||
|
|
)hþ¹ & È 'ˆ‹’–ª®¾ÌÝä
|
|||
|
|
l … ” " %ã ™Ct©¬8šøZÃ`*” n $ ( I 9 ^ €ODHT
|
|||
|
|
·Þ È`d� >„ì yÒ|[óìz' ¸ ÷³Ôš]ì O˾G�+ &j�IÝõ¸ ÎIJoIÌÓ< ™Ct©¬8 ¤Ã›�ê´T gP¬F� /3 ¯¢¡†®` Ý vÿÿvÿÿÿ\ ÿ *nvÿÿvÿÿÿ\ ÿ *n c/Users/tx1138/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/pin-utils-0.1.0/src/stack_pin.rsÁ ¡ñ—çH ‘²Ã9mR[Œ ùù ! "5M D Pªn*gLéŸ ¸}ô%,@ d/Users/tx1138/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/pin-utils-0.1.0/src/projection.rsÁ Oòs’$´'щ]~=ÆzI ééd+
|
|||
|
|
DO#QP0 " "+P
|
|||
|
|
AK # B=D(
|
|||
|
|
.
|
|||
|
|
KPI
|
|||
|
|
$&+M
|