324 lines
183 KiB
Plaintext
324 lines
183 KiB
Plaintext
|
rust
|
|||
|
|
ôÚ #rustc 1.96.0 (ac68faa20 2026-05-25)ÁíàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ stable_deref_traitÁ½ÊTýö÷n˜TóQ-ᆠ-771635b0451f799dÁ ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ yoke_deriveÁº‰ñyåÁðÕCáŠ�ʘà -1f6bb0ffd13f0264Á zerofromÁŠö‘JÁ¯�G™è](^Ø”o -dcafde80b60b6e04Á zerofrom_deriveÁ¨ 8‘ïlÌfOµ— ˆ´ -2ea7b665324646a9Á ‰ ¤,Ì »¤Œ« BoxÁ Ä»¤ŒžÆò»¤ŒÏK ¡»¤Œüa$ $¬ testsÁ, a‚ $•a erasedÁ4œ »¤Œ€ €
|
|||
|
|
ErasedArcCartÁlß»¤Œ·€
|
|||
|
|
ErasedBoxCartÁl$&€ ErasedRcCartÁdý»¤EG€ø Œ»¤Œæ€Æº»¤Œ—€K 黤ŒÄ×o ›»¤Œó× ToOwnedÁ< »¤ í cartable_ptrÁ sentinel_forÁ ¥ SENTINELÁ privateÁ SealedÁ CartablePointerLikeÁ RawÁ into_rawÁ drop_rawÁ CloneableCartablePointerLikeÁ
|
|||
|
|
addref_rawÁ 'aÁ ¥ Ô ¥ ô þ � Ô ¥ ¿ !” !Œ
|
|||
|
|
!
|
|||
|
|
from_cartableÁ ! is_noneÁ &” &ã )” )ƒ ,” .” 0” eitherÁ 2 222 6 C0Á 6 C1Á 6¥ 6å 6´ ; 2=º =Ã =¥ 2Aº AÃ kinda_sorta_danglingÁ D DDDDDD KindaSortaDanglingÁ K¥ K dangleÁ D N¥ Næ N
|
|||
|
|
into_innerÁ DR¥ Rå R´ DV¥ V¶ DY¥ Yã macro_implsÁ \ \\\\ copy_yoke_implÁ \ impl_copy_typeÁ \ unsafe_complex_yoke_implÁ \ dÔ d¥ d 'bÁ d° \iÔ i T1Á iÍ i T2Á iÍ i° \pÔ p¥ pÍ pŸ p p° v utilsÁ x x transform_mut_yokeableÁ zÔ zª z— z£ zÍ yokeÁ € €€€€€€€€€ €
|
|||
|
|
€ YokeÁ Œª ŒÔ Œ” Œ yokeableÁ Œ cartÁ € ’ª ’Ô ’” ’Ô’× €˜ª ˜” ˜Ô ˜Ô˜× €žª ž” žÔ žÔž� €¤ª ¤” ¤Ô ¤Ô€©ª ©” ©Ô ©Ô©ï
|
|||
|
|
€¯ª ¯” ¯Ô ¯Ô¯‹ €µª µÔ µ” µ attach_to_cartÁ ¹— ¹ 'deÁ µ try_attach_to_cartÁ ¼– ¼— ¼Ò µ attach_to_cart_badlyÁ ÀÒ µ try_attach_to_cart_badlyÁ – ÂÒ €Åª ÅÔ Å” Å getÁ ÉÔ Å backing_cartÁ Å into_backing_cartÁ Å replace_cartÁ Í C2Á Í impl FnOnce(C) -> C2Á Å with_mutÁ ÐÔ Ð— ÐÍ Å with_mut_returnÁ ÔÔ Ô— Ô£ ÔÍ Å wrap_cart_in_optionÁ €Úª ÚÔ Ú new_always_ownedÁ Ú
|
|||
|
|
into_yokeableÁ € ߪ ßÔ ß” ß new_ownedÁ ß try_into_yokeableÁ €
|
|||
|
|
åª åÔ å” å convert_cart_into_option_pointerÁ € êª êÔ ê” êä €
|
|||
|
|
CloneableCartÁ € 𥠀
|
|||
|
|
òÔ ò¥ €€öª öÔ ö” öÔöƒ €üª üÔ ü” ü map_projectÁ €¡ €— €Ô €Ôü map_project_clonedÁ … 'thisÁ …¡ …— …Ô …Ôü try_map_projectÁ ‹¡ ‹— ‹– ‹Ô ‹Ôü try_map_project_clonedÁ ‘º ‘¡ ‘— ‘– ‘Ô ‘Ôü !map_project_with_explicit_captureÁ ˜¡ ˜¥ ˜Ô ˜Ôü (map_project_cloned_with_explicit_captureÁ �º �¡ �¥ �Ô �Ôü %try_map_project_with_explicit_captureÁ £¡ £¥ £– £Ô £Ôü ,try_map_project_cloned_with_explicit_captureÁ ©º ©¡ ©¥ ©– ©Ô ©Ô€°ª °Ô °” °
|
|||
|
|
map_with_cartÁ ´¡ ´— ´Ô ´Ô° map_with_cart_clonedÁ ¹º ¹¡ ¹— ¹Ô ¹Ô° try_map_with_cartÁ ¿¡ ¿— ¿– ¿Ô ¿Ô° try_map_with_cart_clonedÁ ź Å¡ Å— Å– ÅÔ ÅԀ̪ ÌÔ Ì” Ì wrap_cart_in_either_aÁ Г Ì wrap_cart_in_either_bÁ Ò’ € €€ õ × × YokeableÁ ÙÔ Ù° Ù transformÁ Ù transform_ownedÁ Ù makeÁ Ù
|
|||
|
|
transform_mutÁ ß— ßÍ × âÔ â¥ â° â� â® âÅ âÑ é— éÍ ×ìÔ ì¥ ì° ì� ì® ìÅ ìÑ ó— óÍ zero_fromÁ ö ööööö üª ü” üÔ üÔü attach_to_zero_copy_cartÁ � CartableOptionPointerÁ ‰” ‰ innerÁ ‰ _cartableÁ �” �× 2
|
|||
|
|
EitherCartÁ �º �à �’ “
|
|||
|
|
“ˆ �“ –
|
|||
|
|
–ˆ 2™º ™Ã ™ƒ 2�º �à 2 º à � 2¤º ¤Ã ¤Ö 2¨º ¨Ã ¨× \¬Ô ¬° ¬� ¬® ¬Å ¬Ñ ²— ²Í \µÔ µ° µ� µ® µÅ µÑ »— »Í \¾Ô ¾° ¾� ¾® ¾Å ¾Ñ Ä— ÄÍ \ÇÔ Ç° Ç� Ç® ÇÅ ÇÑ Í— ÍÍ \ÐÔ Ð° Ð� Ю ÐÅ ÐÑ Ö— ÖÍ \ÙÔ Ù° Ù� Ù® ÙÅ ÙÑ ß— ßÍ \ âÔ â° â� â® âÅ âÑ è— èÍ \
|
|||
|
|
ëÔ ë° ë� ë® ëÅ ëÑ ñ— ñÍ \ ôÔ ô° ô� ô® ôÅ ôÑ ú— úÍ \ ýÔ ý° ý� ý® ýÅ ýÑ ƒ— ƒÍ \
|
|||
|
|
†Ô †° †� †® †Å †Ñ Œ— ŒÍ \�Ô �° �� �® �Å �Ñ •— •Í \˜Ô ˜° ˜� ˜® ˜Å ˜Ñ ž— žÍ \¡Ô ¡° ¡� ¡® ¡Å ¡Ñ §— §Í \ªÔ ª° ª� ª® ªÅ ªÑ °— °Í d� d® dÅ dÑ ¶— ¶Í i� i® iÅ iÑ ¼— ¼Í p� p® pÅ pÑ Â— ÂÍ %
|
|||
|
|
(
|
|||
|
|
+
|
|||
|
|
;
|
|||
|
|
U
|
|||
|
|
X
|
|||
|
|
[
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
Ë
|
|||
|
|
û
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
œ
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
§
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
¯
|
|||
|
|
¸
|
|||
|
|
Á
|
|||
|
|
Ê
|
|||
|
|
Ó
|
|||
|
|
Ü
|
|||
|
|
å
|
|||
|
|
î
|
|||
|
|
÷
|
|||
|
|
€
|
|||
|
|
‰
|
|||
|
|
’
|
|||
|
|
›
|
|||
|
|
¤
|
|||
|
|
|
|||
|
|
ïÙ Ô¥ ¥1 ¥1 ¿c ‰ ‰ š# ‹¿# ŒÌ# »w}ïôÅî ” Œ"Ë1 ØË1 ïË1 ÌìË1 � Ë1 Ø � “ ”’ •ˆ – —“ ˜ˆ úQö}„$§ º à ÐìÃ2 µßÃ2Ã2 ™Ã2 ¿cÃ2 é!Ã2 Ã2 ïÃ2 é! K K Ã
|
|||
|
|
Mã
|
|||
|
|
D *9ó*]Ø ¥ ö!è3 Œ"è3 Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ù Ô Ùۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ«1 Ô Ùè ø Ô Ù«1 Ÿ Ô ¿c Œ Œ Ñ �õ € ‘… € óàì³b‘ ª” Äc¦7 µß¦7¦7 ™¦7 íߦ7¦7 º¦7 ïۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ’4 ï¥1 ï³4 ئ7 Ù «1 Ô Ù• • – PhantomDataÁ Fu\»Ÿ«1 Ô
|
|||
|
|
|
|||
|
|
|
|||
|
|
� ‰¨ �’ Œ& ‰Y K) ‰™ �ö Œ, ‰A �ðÛ¼ò
|
|||
|
|
õ
|
|||
|
|
. ‰0 ‰� � �ž Œ¤ �¤ Œ6 �R K= �V K¬
|
|||
|
|
µ¾ÇÐÙâ ëôý†�˜ ¡ª dÛ¼i
|
|||
|
|
pâ
|
|||
|
|
ì• ˜ Œ© Œ¯ Œ › ¿cŒ"Ø ïÌì � Ðìµß™é! ö! ÙÄccíߺĜ 4
|
|||
|
|
" „œ
|
|||
|
|
ñ’4 3 D ³ üóL K ’4 ¾ Å ü¾‡ P è3 $ä ’4 4Ö ÑÛÑÛ MaybeUninitÁ ÓÛ uninitÁÝ ÔÛ»Ý Íõƒ«%9’4 ú ’4 ù ã
|
|||
|
|
i ˜ üŠÇ! D¢Ç
|
|||
|
|
% ¼ŠÇ
|
|||
|
|
Pà7 4 G ªÇ $¿Ç Û¼ æ7 ü›Æ³ Œ à7ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙæ7 ÍÇ ÔÇ üåÅï ã Œ Œ Ñ �õ € ‘… € óàì³b‘à7�@ $ŒÆ à7 DüÅ K K Ã
|
|||
|
|
Mã
|
|||
|
|
D *9ó*]Øà7 � à7 � �@ K õO ¾ Ö† ŒÈ† Ô ³4 ц & ()Á ç» ŒÙ» Õ ³4 â» & ()Á ݉ ŒÏ‰ Ö ³4 ؉ & ()Á ¾ � ‹3‘3 ” + Ã2 6 ‹3 = D É �‹3‘3 — + Ã2 6 ‘3 = D 2D\x€×öí ý DÏ Ù ‡ý P ƒçlð ï …Ñ$ÿ Œ † ZeroFromÁDÕ
|
|||
|
|
ˆ«E 4 ˆü²¬ ü™j g This crate provides [`Yoke<Y, C>`][Yoke], which allows one to "yoke" (attach) a zero-copy deserializedÁ ü„‡ „ object (say, a [`Cow<'a, str>`](alloc::borrow::Cow)) to the source it was deserialized from, (say, an [`Rc<[u8]>`](alloc::rc::Rc)),Á üŒi f known in this crate as a "cart", producing a type that looks like `Yoke<Cow<'static, str>, Rc<[u8]>>`Á üö* ' and can be moved around with impunity.Á ¡ ú ü¥f c Succinctly, this allows one to "erase" static lifetimes and turn them into dynamic ones, similarlyÁ üŒT Q to how `dyn` allows one to "erase" static types and turn them into dynamic ones.Á á ú üåX U Most of the time the yokeable `Y` type will be some kind of zero-copy deserializableÁ ü¾ U R abstraction, potentially with an owned variant (like [`Cow`](alloc::borrow::Cow),Á ü”
|
|||
|
|
‚ [`ZeroVec`](https://docs.rs/zerovec), or an aggregate containing such types), and the cart `C` will be some smart pointer likeÁ ü— Ž ‹ [`Box<T>`](alloc::boxed::Box), [`Rc<T>`](alloc::rc::Rc), or [`Arc<T>`](std::sync::Arc), potentially wrapped in an [`Option<T>`](Option).Á ¦ ú üª d a The key behind this crate is [`Yoke::get()`], where calling [`.get()`][Yoke::get] on a type likeÁ ü�
|
|||
|
|
a ^ `Yoke<Cow<'static, str>, _>` will get you a short-lived `&'a Cow<'a, str>`, restricted to theÁ üñ
|
|||
|
|
p m lifetime of the borrow used during [`.get()`](Yoke::get). This is entirely safe since the `Cow` borrows fromÁ üâr o the cart type `C`, which cannot be interfered with as long as the `Yoke` is borrowed by [`.get()`](Yoke::get).Á üÕi f [`.get()`](Yoke::get) protects access by essentially reifying the erased lifetime to a safe local oneÁ œ¿ when necessary.Á Ó ú ü×7 4 See the documentation of [`Yoke`] for more details.Á 2D\x€×öíÌ ý Í Ù ‡ý Þ P ƒçÍ ï …ÑÌ Œ †«EÃ
|
|||
|
|
ˆ«EÕ 4 ˆCFI¤Ô üË8 5 Types for optional pointers with niche optimization.Á „ú üˆN K The main type is [`CartableOptionPointer`], which is like `Option<Rc>` butÁ ü×M J with a niche so that the resulting `Yoke` has a niche. The following fourÁ ü¥7 4 types can be stored in the `CartableOptionPointer`:Á Ýú \á 1. `&T`Á |í 2. `Box<T>`Á tý 3. `Rc<T>`Á |Œ 4. `Arc<T>`Á œú ü O L These four types implement the sealed unsafe trait [`CartablePointerLike`].Á üðK H In addition, all except `Box<T>` impl [`CloneableCartablePointerLike`],Á ü¼@ = which allows [`CartableOptionPointer`] to implement `Clone`.Á dÜ ‰çl‰ ï …»8\Û • »8 – §<÷ ‰ StableDerefÁ\˜ É4�
|
|||
|
|
¤‚€ÌÍo”ìOü„ 8ü‘ "d” ‰‰ § ‹‰ ï íe¼îËè¿*’4 ¥ Íì’4 ¡
|
|||
|
|
’4
|
|||
|
|
¤º DÁ Ã4 ƒ \Ù <Ý „ë 4õ Îì œë ã^ ã^ |†Eü�: ü˜8 5 An object fully representable by a non-null pointer.Á Ñú dÕ # SafetyÁ âú ¼æ Implementer safety:Á þú ü‚` ] 1. `into_raw` transfers ownership of the values referenced by [`StableDeref`] to the caller,Á üã( % if there is ownership to transferÁ üŒW T 2. `drop_raw` returns ownership back to the impl, if there is ownership to transferÁ äú üè_ \ Note: if `into_raw` returns the sentinel pointer, memory leaks may occur, but this will notÁ üÈ lead to undefined behaviour.Á éú üíX U Note: the pointer `NonNull<Self::Raw>` may or may not be aligned and it should neverÁ üÆV S be dereferenced. Rust allows unaligned pointers; see [`std::ptr::read_unaligned`].Á œ® ã^ü�Ø ë^ \à ë^ 4Ñ ã^4 Äe) Òe ã^C Äe8 Òe/ Íìë^ Lº ”f Dº üÞD A The raw type used for [`Self::into_raw`] and [`Self::drop_raw`].Á 4 ¿ ü�( üÉ. + Converts this pointer-like into a pointer.Á 4‚ D’ ë^‰‰ § ‹‰ ï íe¼îËè¿*œf
|
|||
|
|
ë^$›üÃ0 ü½7 4 Drops any memory associated with this pointer-like.Á ùú d�ò^ ’ú ”š Caller safety:Á ±ú ü¹E B 1. The pointer MUST have been returned by this impl's `into_raw`.Á üƒ( % 2. The pointer MUST NOT be dangling.Á 4¶ DÍ ªh³4
|
|||
|
|
ë^‰ <Öü÷B ü÷? < An object that implements [`CartablePointerLike`] that alsoÁ ü·E B supports cloning without changing the address of referenced data.Á ýú d�ò^ Žú ¼’“_ ªú ü®K H 1. `addref_raw` must create a new owner such that an additional call toÁ üú4 1 `drop_raw` does not create a dangling pointerÁ ü¯G D 2. `addref_raw` must not change the address of any referenced data.Á äˆ ã^ü÷é ë^ œ¦ ã^& Ão ã^0 Ão% ü¬ 2 ìÀ Clones this pointer-like.Á â ú dê ò^ û ú ”ƒ ëh š ú ü¢ E“i üì (âi 4Ÿ T¶ ªh³4
|
|||
|
|
ë^‰ <Á äâ Ô ¥ Íì«1 ë ¥1 ç
|
|||
|
|
üÞ 0 Ô ¥ úq î ¥1 ê "$ D• š «1ü¶ D¹ ¥1‰‰ § ‹‰ ï íe¼îËè¿*«1
|
|||
|
|
Ô«1$Â ü„!(DŽ! ²s³4
|
|||
|
|
Ô«1 _pointerÁD—!üÏ"9 Ô ¥ úq ß"¥1 Û" ü�#*T§# ²s³4
|
|||
|
|
Ô«1ÈsD²#üÌLB ” "
|
|||
|
|
ˆ üØ#Tæ è3’4 N N
|
|||
|
|
Q’4$ñüæ0 ¥ S S ß] ë ©…<îè3TU ê! ë! U \�4¢ R R ’4¬À,Ã É Éè3 É’4 R É R
|
|||
|
|
U’4$Êü©3 ¥ W W ß] ® ©…<±è3X ÷! X üñ!Lô Ê Êè3 Ê’4 V þ V
|
|||
|
|
X’4$ƒüê/ ¥ Z Z ß] ï ©…<òè3[ �" [ ”®$± Ë Ëè3³4 Y ¶ Y
|
|||
|
|
[’4$»|¾ \ ý D× Ù \ ] ‡ý P \ ] ƒ†ƒdñ ÃÛ \ _µ ÿ “ \ `|ÐU$åŒì2 "܆t“ ¢ Œ ¨ © *« ® ‰ 3 + ¸ ¹ À 8Ý 4º 8 Ê 8� LÍ Ö Ü × 8 $Ø (Þ á 8 $â 'æ 8° 4è ï Š 8 $ý + ” • œ 8Ý 4– 8 ¦ 8® |© ¸ ½ 8 $¹ (¿ 8 $ 'Æ 8° 4È Ï ê 8 $Ý + ô õ ü 8Ý 4ö 8" 4† 8 � 8Å $� ” § 8 thisÁ $• & ™ 8 $› 'Ÿ 8° 4¡ (© 8 $¬ ± Ì 8¼Ž $¿ + Ö × Þ 8Ý 4Ø 8 è 8Ñ lë ø 8— ù ú û Ž ü :Ô ý 8 € 8 $„ $ ˆ 8± Š & ‹ 8— � 8$ ,˜ 8— ª & « :7 < µ 8
|
|||
|
|
· º :Í » ½ 8† 4¿ Å Ú Æ :Í Ç 8 Ê 8 $Î 'Ò 8° 4Ô $ Û å ƒ 8± ó ô ù 8 $õ % Š ÜŽt› ª ½ ° · , ± 8´ ² & ´ 8´ µ *¹ ¼ º
|
|||
|
|
8" 4Æ 8 $Í Ñ :Ô Ò Ô 8ý DÖ Þ :Ô ß á 8
|
|||
|
|
ã , ç 8´ è ë ´ 8! $ù 8° 4þ … 8 $‡ % ‹ 8ò t™ § ¨ © % ª % » üõ
|
|||
|
|
%Ä‚ › Š ¡ ¢ *¤ § ‡ , 8 ± 8� L´ ½ Æ ¾ :Ô ¿ 8 $Â (È Ë :Ô Ì 8 $Ï 'Ó 8° 4Õ Ü ˆ 8" 4Æ Í þ Ï
|
|||
|
|
Ð Ñ ü 8 $Ò 8 ×
|
|||
|
|
Ú 8 ,Û 8 $á 8 æ
|
|||
|
|
é 8 ,ê 8 $ð 'ô 8° 4ö 8 “ 8® |– ¥ ª 8 $¦ (¬ 8 $¯ '³ 8° 4µ ¼ ã 8" 4¦ Ù 8 ¿ 8µ Ã & Æ
|
|||
|
|
È 8 ,É 8 $Ï 'Ó 8° 4Õ Ü Þ ó ß 8 $à 8 å
|
|||
|
|
è 8 ,é 8 $ï ô 8 castÁ $õ ù ú % û 8 � 8 ‘ “ 8†ƒ d• '¡ 8æ £ ¦ « 8 $§ % ¬ 8µ ¾ 'Á 8 readÁ $Ã Ç Ë 8µ È 8" 4î 8 õ 8Å $ø ü � 8÷ $ý & � 8 $ƒ '‡ 8° 4‰ (‘ 8 $” ™ µ 8 debug_assertÁ d§ ³ ´ ã 8š <µ '¼ ¾ 8 $¿ 'à 8° 4Å Ë Ì Í Ï 8š <Ò 'Ù Û 8 $Ü à á â % ä 8 ò 8µ ö ú ü 8÷ $ý 8 ‚
|
|||
|
|
… 8 ,† 8 $Œ '� 8° 4’ 8 ™
|
|||
|
|
œ 8 ,� 8 $£ % § 8 µ 8 ¹ » 8†ƒ d½ 'É 8æ Ë Î Ó 8÷ $Ï % Ô 8" 4“ š « 8µ œ 'Ÿ 8š $¡ ¥ © 8µ ¦ 8 À 8Ñ là Р8— Ñ Ò Ó æ Ô :Ô Õ 8 Ø 8 $Ü $ à 8± â & ã 8— å 8$ ,ð 8— ‚ & ƒ :7 <… � 8
|
|||
|
|
� ’ :Í “ • 8† 4— � ² ž :Í Ÿ 8 ¢ 8 $¦ 'ª 8° 4¬ $ ³ ½ � 8 ,Ë 'Ð 8¾
|
|||
|
|
,Ò '× 8Î
|
|||
|
|
´Ù ï ÷ 8 $ð $ ô 8± ö % ˆ ü˜M Ô e ¥ f e f úq ¨ «1<« g Ù«1 g ¤µ¡6h³´µ¶ Û Ü Ý Þ ß ¶ µ ³ ´ ¤df ¹\ì4ñ d d ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ«1 Ô ÛüÕu Ô j è k ø m k m j Íìø6 å Íìý6 ‰ ø6<é l Ùø6 l ¤ó ý6<� n Ùý6
|
|||
|
|
” K € …¾
|
|||
|
|
,Ì x € †ý DÞ Ù € ‡ ‡ý P € ‡ ƒ»8\ú • € ˆ»8 – € ˆ†ƒd– ÃÛ € ‰r,³ é! € Š®[\Ò € ‹œÏ ñóÌ–åü�/×dÅÉ|×»Ì쑼‹l„¨]ü¾ OüÅ+ üï; 8 A Cow-like borrowed object "yoked" to its backing data.Á «ú ü¯G D This allows things like zero copy deserialized data to carry aroundÁ ü÷Q N shared references to their backing buffer, by "erasing" their static lifetimeÁ üÉ2 / and turning it into a dynamically managed one.Á üú ü€C @ `Y` (the [`Yokeable`]) is the object containing the references,Á üÄF C and will typically be of the form `Foo<'static>`. The `'static` isÁ ü‹ R O not the actual lifetime of the data, rather it is a convenient way to mark theÁ üÞ ( % erased lifetime and make it dynamic.Á ‡
|
|||
|
|
ú ü‹
|
|||
|
|
Z W `C` is the "cart", which `Y` may contain references to. After the yoke is constructed,Á üæ
|
|||
|
|
Y V the cart serves little purpose except to guarantee that `Y`'s references remain validÁ üÀ d a for as long as the yoke remains in memory (by calling the destructor at the appropriate moment).Á ¥ ú ü© ` ] The primary constructor for [`Yoke`] is [`Yoke::attach_to_cart()`]. Several variants of thatÁ üŠ
|
|||
|
|
Y V constructor are provided to serve numerous types of call sites and `Yoke` signatures.Á ä
|
|||
|
|
ú üè
|
|||
|
|
c ` The key behind this type is [`Yoke::get()`], where calling [`.get()`][Yoke::get] on a type likeÁ üÌaÞO ü®c ` lifetime of the borrow used during `.get()`. This is entirely safe since the `Cow` borrows fromÁ ü’a ^ the cart type `C`, which cannot be interfered with as long as the `Yoke` is borrowed by `.getÁ üôa ^ ()`. `.get()` protects access by essentially reifying the erased lifetime to a safe local oneÁ œÖ±S êú üîl i Furthermore, there are various [`.map_project()`][Yoke::map_project] methods that allow turning a `Yoke`Á üÛc ` into another `Yoke` containing a different type that may contain elements of the original yokedÁ ü¿A > value. See the [`Yoke::map_project()`] docs for more details.Á �ú ü…\ Y In general, `C` is a concrete type, but it is also possible for it to be a trait object.Á âú læ
|
|||
|
|
# ExampleÁ ôú üøQ N For example, we can use this to store zero-copy deserialized data in a cache:Á Êú \Î ```rustÁ ¬Ú # use yoke::Yoke;Á ´ð # use std::rc::Rc;Á ܇ # use std::borrow::Cow;Á ü£7 4 # fn load_from_cache(_filename: &str) -> Rc<[u8]> {Á üÛ! # // dummy implementationÁ üýK H # Rc::new([0x5, 0, 0, 0, 0, 0, 0, 0, 0x68, 0x65, 0x6c, 0x6c, 0x6f])Á <É # }Á Ñú üÕI F fn load_object(filename: &str) -> Yoke<Cow<'static, str>, Rc<[u8]>> {Á üŸ5 2 let rc: Rc<[u8]> = load_from_cache(filename);Á üÕO L Yoke::<Cow<'static, str>, Rc<[u8]>>::attach_to_cart(rc, |data: &[u8]| {Á ü¥5 2 // essentially forcing a #[serde(borrow)]Á üÛ> ; Cow::Borrowed(bincode::deserialize(data).unwrap())Á Tš })Á ,¥ }Á «ú ü¯/ , let yoke = load_object("filename.bincode");Á üß' $ assert_eq!(&**yoke.get(), "hello");Á ü‡5 2 assert!(matches!(yoke.get(), &Cow::Borrowed(_)));Á <½ ```Á $Ð ª � ” � � � Íìà7 Õ Íìæ7 î Ž Ùà7 Ž ¤Ø¦7 óàì³b‘ �‘LN ÜOQ üñ Dñ € Œ Œ êA<ñ"$ñ"€ Œ Œ æ7üÿ#“ ª “ ” • “ • ûÈ „$ ‹É �$ ” Ùà7 ” ¤‡$ ¿cæ7 „ $ – ¿cà7 – Û „�%¦7— Àc — jl ‹$uw à$ü™%D œ% Ì Í Î Ì¦7 Í c c ˆ ¢cµ
|
|||
|
|
` £c bufÁ ` àB¤GS
|
|||
|
|
ÎÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
³4ŸÈŸÈ È ErrorÁ O˜éBL ’ % ’
|
|||
|
|
—à7æ7$¡%± §%üù&Œ ª ™ ” š š ™ ûÈ þ& ‹É �' › Ùà7 › ¤³' œ Äcà7 œ Û ”ò'¦7� Åc � [] `b ·'Ñ'üŒ(D �( Ï Ð Ñ Ï¦7 Ð c c ˆ ¢cµ
|
|||
|
|
` £cÏË ` àB¤GS
|
|||
|
|
ÑöÌ ˜ “( ˜
|
|||
|
|
�à7æ7$”(± š(ü‹)z ª Ÿ ” Ÿ ûÈ �) ‹É “) ¡ Ùà7 ¡ ¤¼) ¢ µßà7 ¢ ÛùÑ Lû)¦7£ ·ß £ ac fh À)Ú)üŒ*"�* Ò Ó Ò¦7 Ó¦7 ž ’* ž
|
|||
|
|
£à7æ7$“*¹
|
|||
|
|
,™*üÜ*l ª ¥ ” ¦ ¦ ¥ ûÈ á* ‹É ä* § Ùà7 § ¤†+ ¨ ™à7 ¨ Û Å+¦7 PR UW Š+¤+üÎ+| ª ª ” « « ª ûÈ Ó+ ‹É Ö+ ¬ Ùà7 ¬ ¤€, íßà7 ÛËÕ T¿,¦7® ïß ® ac fh „,ž,üÑ,B\Ô, Ô Õ Ô¦7 Õ¦7 ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ¿ßÀßÁß LessÁ Âß ÃßÄß~ Åß ÆßÇß GreaterÁ Èß åºÝÈnûê7 © à, ©
|
|||
|
|
®à7æ7$á,¹
|
|||
|
|
,ç,üË-n ª ° ” ± ± ° ûÈ Ð- ‹É Ó- ² Ùà7 ² ¤ö- ³ ºà7 ³ Û µ.¦7´ » ´ [] `b ú-”.üÀ.2 Ã. Ö × Ö¦7 צ7 £× ¯ Ç. ¯
|
|||
|
|
´à7æ7$È.¹
|
|||
|
|
,Î.üŸ<a ª ¶ ” ¸ ¶ ¸ ûÈ ¤< ‹É ½< · Ùà7 · ¤§< æ7 \À< æ7 ê!<ø<¦7¹¼À WY «<bd ü¡R£ ü‡=E B Construct a [`Yoke`] by yokeing an object to a cart in a closure.Á Ñ=ú üÙ=Q N The closure can read and write data outside of its scope, but data it returnsÁ ü¯>< 9 may borrow only from the argument passed to the closure.Á ð>ú üø>R O See also [`Yoke::try_attach_to_cart()`] to return a `Result` from the closure.Á Ï?ú ü×?U R Call sites for this function may not compile pre-1.61; if this still happens, useÁ ü±@4 1 [`Yoke::attach_to_cart_badly()`] and file a bug.Á ê@ú tò@ # ExamplesÁ …Aú <�AÅÇ ¬™A¿À ´³AÝÀ ÜÎAüÀ üîA7¡Á üªB!âÁ üÐBK� < Cá ¬Cú ü´CIþ ü‚D5Ñà ü¼DO�Ä ü�E5éÄ üÊE>¨Å T�FïÅ ,œF‚Æ ¦Fú ü®FB ? let yoke: Yoke<Cow<str>, _> = load_object("filename.bincode");Á üõF'ÖÆ ü¡G5‡Ç <ÛGÅÇ çGú üïG; 8 Write the number of consumed bytes to a local variable:Á ¯Hú <·HÅÇ ¬ÃH¿À ´ÝHÝÀ ÜøHüÀ ü˜I7¡Á üÔI!âÁ üúI? < # Rc::new([0x5, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0, 0, 0])Á <¾Já ÊJú œÒJ fn load_object(Á ¼êJ filename: &str,Á ü†K5 2 ) -> (Yoke<Cow<'static, str>, Rc<[u8]>>, usize) {Á üÀK5Ñà üúK$ ! let mut bytes_remaining = 0;Á ü£L3 0 let bytes_remaining = &mut bytes_remaining;Á üÛLG D let yoke = Yoke::<Cow<'static, str>, Rc<[u8]>>::attach_to_cart(Á |§M rc,Á Ü»M |data: &[u8]| {Á üÛME B let mut d = postcard::Deserializer::from_bytes(data);Á ü¥NE B let output = serde::Deserialize::deserialize(&mut d);Á üïN? < *bytes_remaining = d.finalize().unwrap().len();Á ü³O. + Cow::Borrowed(output.unwrap())Á tæO },Á TùO );Á üˆP (yoke, *bytes_remaining)Á ,P‚Æ ·Pú ü¿PC @ let (yoke, bytes_remaining) = load_object("filename.postcard");Á ü‡Q'ÖÆ ü³Q5‡Ç üíQ# assert_eq!(bytes_remaining, 3);Á <•RÅÇt¨R æ7ܪ¦7 µ— º º µ µ« ·R » –"ܪ »ÆÛ üÒUJ » ܪ¹í˜" à7 » Ûä€V ÄÛ<¼V
|
|||
|
|
¹à7æ7ܪ…$ºR± ÃR|~ ÖUüä\Ô ü©ZR O Construct a [`Yoke`] by yokeing an object to a cart. If an error occurs in theÁ ü€[@ = deserializer function, the error is passed up to the caller.Á Å[ú üÍ[U„Þ ü§\8 5 [`Yoke::try_attach_to_cart_badly()`] and file a bug.Á”ë\ æ7—Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¦7– µ– ½ — ¾ ¾ ½ µ Íì±ñ þ\ ÍìÛð �] ¿ –"Ûð ¿ÆÛ ü»]U ¿ Ûð˜ò˜" Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
à7 ¿ Û±ñüé]' ÄÛ<°^
|
|||
|
|
¼à7æ7±ñÛð…$„]± �]äæ àâ ¿]üÍcŽ ü¢b# Use [`Yoke::attach_to_cart()`].Á Êbú üÒbd a This was needed because the pre-1.61 compiler couldn't always handle the [`FnOnce`] trait bound.Á l»c¤Ôc æ7 Á ÁÆÛ à7 Á Û ¦7 µ µ
|
|||
|
|
Àà7æ7…$òc± ƒd Šdü¾f« ü�e' $ Use [`Yoke::try_attach_to_cart()`].Á »eú üÃedÀó l¬fÄÅf æ7 Ä ÄÆÛ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
à7 Ä Û±ñ àð µ– à à µ æñ Þf
|
|||
|
|
Âà7æ7±ñ…$êf± ûf#% ‚güŸh+ ª Æ ” È Æ È ûÈ ¤h ‹É ½h Ç Ùà7 Ç ¤§h¦7ÉËÌÍÐÔÙ AC «hLN ü×q; üÑh1 . Obtain a valid reference to the yokeable dataÁ
|
|||
|
|
be valid.Á üóiJ G For example, if you're working with a `Yoke<Cow<'static, T>, C>`, thisÁ üÂj# will return an `&'a Cow<'a, T>`Á êjú lòj¢¿ „kú \Œk«À ¬œk¿À ´¶kÝÀ ÜÑküÀ üñk7¡Á ül!âÁ üÓlK� <£má ,¯m #Á ü¹mK H # fn load_object(filename: &str) -> Yoke<Cow<'static, str>, Rc<[u8]>> {Á ü‰n7 4 # let rc: Rc<[u8]> = load_from_cache(filename);Á üÅnQ N # Yoke::<Cow<'static, str>, Rc<[u8]>>::attach_to_cart(rc, |data: &[u8]| {Á ü›o@ = # Cow::Borrowed(bincode::deserialize(data).unwrap())Á dào # })Á <ñoá ýoú ü…pC @ // load_object() defined in the example at the top of this pageÁ üÍpB³á ü”q$ ! assert_eq!(yoke.get(), "hello");Á <½qÅÇ Þq Ê Ê¦7 Êà7 Ê Û Å âq Å
|
|||
|
|
Éà7æ7$êq üµt üÂr( % Get a reference to the backing cart.Á ïrú ü÷rX U This can be useful when building caches, etc. However, if you plan to store the cartÁ üÔs\ Y separately from the yoke, read the note of caution below in [`Yoke::into_backing_cart`].Ád¼t Ø Ø¦7 Øæ7 Å Ét Å
|
|||
|
|
Ëà7æ7$Êtü¢�# üöt@ = Get the backing cart by value, dropping the yokeable object.Á »uú üÃu] Z **Caution:** Calling this method could cause information saved in the yokeable object butÁ ü¥v[ X not the cart to be lost. Use this method only if the yokeable object cannot contain itsÁ ¤…w own information.Á žwú l¦w¢¿ ¸wú üÀwY V Good example: the yokeable object is only a reference, so no information can be lost.Á žxú <¦xÅÇ œ²x use yoke::Yoke;Á Êxú üÒx& # let local_data = "foo".to_owned();Á üýxK H let yoke = Yoke::<&'static str, Box<String>>::attach_to_zero_copy_cart(Á ìÍy Box::new(local_data),Á 4ïy );Á üúy# assert_eq!(*yoke.get(), "foo");Á ¢zú Īz // Get back the cartÁ üÇz( % let cart = yoke.into_backing_cart();Á ôôz assert_eq!(&*cart, "foo");Á <—{ÅÇ £{ú ü«{@ = Bad example: information specified in `.with_mut()` is lost.Á ð{ú <ø{ÅÇ Ì„| use std::borrow::Cow;Á œ¢|¸ˆ º|ú üÂ|&ሠ”í| let mut yoke =Á ü„}I F Yoke::<Cow<'static, str>, Box<String>>::attach_to_zero_copy_cart(Á üÒ}! Box::new(local_data),Á Tø}íé ü‡~" assert_eq!(yoke.get(), "foo");Á ®~ú ü¶~ // Override data in the cartÁ ÌÛ~ yoke.with_mut(|cow| {Á üù~# let mut_str = cow.to_mut();Á Ä¡ mut_str.clear();Á ü¾ mut_str.push_str("bar");Á <ã });Á üï" assert_eq!(yoke.get(), "bar");Á –€ú Äž€ÓŠ ü»€(õŠ üè€) & assert_eq!(&*cart, "foo"); // WHOOPS!Á <–�ÅÇŒ©� ¦7æ7 Å Å
|
|||
|
|
Ìà7æ7$»�ü��L üå�7 4 Unsafe function for replacing the cart with anotherÁ ¡‚ú ü©‚< 9 This can be used for type-erasing the cart, for example.Á ê‚ú dò‚ò^ ƒƒú ü‹ƒT Q - References from the yokeable `Y` should still be valid for the lifetime of theÁ ìäƒ returned cart type `C`.Á †„ú üŽ„^ [ For the purpose of determining this, `Yoke` guarantees that references from the YokeableÁ üñ„b _ `Y` into the cart `C` will never be references into its stack data, only heap data protectedÁ üØ…e b by `StableDeref`. This does not necessarily mean that `C` implements `StableDeref`, rather thatÁ ü†e b any data referenced by `Y` must be accessed through a `StableDeref` impl on something `C` owns.Á ¬‡ú ü´‡g d Concretely, this means that if `C = Option<Rc<T>>`, `Y` may contain references to the `T` but notÁ ¤ ˆ anything else.Á ü¹ˆ[ X - Lifetimes inside C must not be lengthened, even if they are themselves contravariant.Á ü™‰X U I.e., if
|
|||
|
|
fn slice(Á ü½¢) & y: Yoke<&'static [u8], Rc<[u8]>>,Á üë¢: 7 ) -> Result<Yoke<&'static str, Rc<[u8]>>, Utf8Error> {Á üª£@ = y.try_map_project(move |bytes, _| str::from_utf8(bytes))Á ,ï£‚Æ <ù£ÅÇ …¤ú ü�¤9Ó‚ ˤú <Ó¤ÅÇ üߤ!𥠜…¥·¦ ´�¥ÝÀ ü¸¥&�™ ,ã¥æü üí¥*ëƒ ¤œ¦‘¬ Ôµ¦ bytes_1: &'a [u8],Á ÔԦф ,ó¦‚Æ ý¦ú ä…§�… ü¦§*·… üÕ§:‹š ü”¨A > bar.try_map_project(|bar, _| str::from_utf8(bar.bytes_1))Á ,Ú¨‚Æ ä¨ú ,ì¨æü üö¨5€‡ ü°© À‡ üÕ©1ë‡ ”‹ª¦ˆ \¢ªÂˆ ,²ªæü ü¼ª/æˆ üðª< ‰ ”±«¦ˆ \ȫˆ ,Ø«æü üâ«1‘Š ü˜¬-ÍŠ \ʬˆ ,Ú¬æü üä¬1¡‹ |šÜ‹ ü®8ö‹ \브 üû0ÎŒ \°®Âˆ <À®á <Ì®ÅÇ|ß® ¦7ÛðÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ËŽ– ü¡ Œ — � – Ž Œ � Ž ü ½� ï® ÷ñ ò® Íìø¢ õ® � Ù…� � ¤²¯ � –"Ûðà7 � Û• • – »8 Fu\»Ÿ �³4 üÓ¯� � Ûð�¤˜" Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
…� � Ûø¢üº°&
|
|||
|
|
‹à7æ7…�Ûðø¢$ø®± þ®FI LO IL ¶¯×¯üº·¿ üØ´J G This is similar to [`Yoke::try_map_project`], however it does not moveÁ ü§µR²‘ þµú ü†¶aœ’ üì¶Iˆ“´Á· ð”ù”Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
þ”– üº ’ ¡ “ — ” – • ” ’ • “ ü ý• ß· �– â· ÍìϨ å· – Ù¸• – ¤©¸ ð÷lʸ — –"ù” ºà7 — Û • • – »8 Fu\»Ÿ —³4 ü且 — ù”ü©˜" Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¸• — ÛϨüÒ¹&
|
|||
|
|
‘à7æ7 º¸•ù”Ϩ$ï·± õ·,Ø·cf il fi ¸è¸üŽÀ³ üÕ½P M This is similar to [`Yoke::map_project`], but it works around older versionsÁ üª¾N K of Rust not being able to use `FnOnce` by using an explicit capture input.Á üý¾B ? See [#1061](https://github.com/unicode-org/icu4x/issues/1061).Á Ä¿ú üÌ¿= : See the docs of [`Yoke::map_project`] for how this works.Áü•À! ¦7¥ œà7 œ ÛÀ¯• • – »8 Fu\»Ÿ œ³4 …� œ Û ËŽ ü¡ ™ ¥ š ™ š ü ½� ·À ÍìÀ¯ ºÀ › Ù…� › ¤¬Â
|
|||
|
|
˜à7æ7…�À¯$ÆÀ captureÁ<ÔÀ± èÀjl eg °ÂïÀü²Éé üëÆW T This is similar to [`Yoke::map_project_cloned`], but it works around older versionsÁ üÇÇN¯¬ üšÈBˆ áÈú üéÈD A See the docs of [`Yoke::map_project_cloned`] for how this works.Áü¹É( ž ž¦7 À¯ ¢ žà7 ¢ Û À¯• • – »8 Fu\»Ÿ ¢³4 …� ¢ Û ËŽ ü¡ Ÿ ¥ Ÿ ,âÉ ü ½� éÉ æ° ìÉ ¡ Ù…� ¡ ¤ìË ð÷l�Ì
|
|||
|
|
�à7æ7…�À¯$ÿɳ°<�ʱ ¡Êrthj ln ð˨ÊüäÒÐ üüÏT Q This is similar to [`Yoke::try_map_project`], but it works around older versionsÁ üÕÐN¯¬ ü¨ÑBˆ ïÑú ü÷ÑA > See the docs of [`Yoke::try_map_project`] for how this works.ÁüëÒ% ¦7À¯ ¨à7 ¨ ÛÀ¯• • – »8 Fu\»Ÿ ¨³4 Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
…� ¨ Ûø¢ ¦¢ ü¡ ¤ ¥ ¥ – ¦ ¤ ¥ ¦ ü
|
|||
|
|
the cart.Á ‚æú üŠæ\ Y If access to the old [`Yokeable`] `Y` is sufficient to produce the new [`Yokeable`] `P`,Á üëæX U then [`Yoke::map_project`] should be preferred, as `map_with_cart` places additionalÁ äÈç constraints on the cart.Á éçú üñç_ \ This can be used, for example, to transform data between two formats, one of which containsÁ tÕè more data:Á èèú <ðèÅÇ üüè!𥠜¢é·¦ ´ºéÝÀ ,Õéæü üßé\ Y // Both structs have `first_line`, which won't need to be recomputed in `map_with_cart`.Á üÀê0 - // They also safely implement `Yokeable<'a>`Á ¤õê struct Foo<'a> {Á üŽë$ ! first_line: Option<&'a str>,Á ,·ë‚Æ ¤Á둬 üÚë$ïÈ üƒì# last_line: Option<&'a str>,Á ,«ì‚Æ µìú ”½ì fn foo_to_bar(Á üÔì) & foo: Yoke<Foo<'static>, Rc<str>>,Á ü‚í& # ) -> Yoke<Bar<'static>, Rc<str>> {Á üí' $ foo.map_with_cart(|foo, cart| {Á ŒÙí Bar {Á üïí+ ( first_line: foo.first_line,Á üŸî4 1 last_line: cart.lines().next_back(),Á lØî
|
|||
|
|
}Á TêîïÅ ,ùî‚Æ ƒïú ”‹ï fn bar_to_foo(Á ü¢ï) & bar: Yoke<Bar<'static>, Rc<str>>,Á üÐï& # ) -> Yoke<Foo<'static>, Rc<str>> {Á üûï" bar.map_project(|bar, _| {Á Œ¢ð Foo {Á ü¸ð+ ( first_line: bar.first_line,Á lèðÔÌ TúðïÅ ,‰ñ‚Æ “ñú ,›ñæü ü¥ñ5 2 # unsafe impl<'a> Yokeable<'a> for Foo<'static> {Á üßñ # type Output = Foo<'a>;Á ü„ò1 . # fn transform(&'a self) -> &'a Foo<'a> {Á ”ºò¦ˆ \Ñòˆ ,áòæü üëò/ , # fn transform_owned(self) -> Foo<'a> {Á üŸó< ‰ ”àó¦ˆ \÷óˆ ,‡ôæü ü‘ô1 . # unsafe fn make(from: Foo<'a>) -> Self {Á üÇô-ÍŠ \ùôˆ ,‰õæü ü“õ1¡‹ |ÉõÜ‹ üÝõ8ö‹ \šö¸Œ üªö0ÎŒ \ßöˆ <ïöá ,ûöæü ü…÷5€‡ ü¿÷ À‡ üä÷1ë‡ ”šø¦ˆ \±øˆ ,Áøæü üËø/æˆ üÿø< ‰ ”Àù¦ˆ \×ùˆ ,çùæü üñù1‘Š ü§ú-ÍŠ \Ùúˆ ,éúæü üóú1¡‹ |©ûÜ‹ ü½û8ö‹ \úû¸Œ üŠü0ÎŒ \¿üˆ <Ïüá <ÛüÅÇlý ¦7ÛðËŽ °¡ µ — ¶ µ ¶ ° ½� »ý ÷ñ ¾ý · Ù…� · ¤ðý ¸ –"Ûðà7 ¸ Û ¸ÆÛ ü‘þ‡ ¸ ÛðÏؘ" …� ¸ ÛÜýþ ÄÛ<¸ÿ
|
|||
|
|
´à7æ7…�Ûð$Áý± ÇýÁà ÅÇ ôý•þüªˆÐ üÛƒY V This is similar to [`Yoke::map_with_cart`], but it does not move [`Self`] and insteadÁ ü¹„> ; clones the cart (only if the cart is a [`CloneableCart`]).Á ü„ú ü„…K H This is a bit more efficient than cloning the [`Yoke`] and then callingÁ üÔ…\ Y [`Yoke::map_with_cart`] because it will not clone fields that are going to be discarded.Á µ†ú ü½†\Üà üž‡[ X then [`Yoke::map_project_cloned`] should be preferred, as `map_with_cart_cloned` placesÁ üþ‡' $ additional constraints on the cart.Á¤±ˆ ð”ù”þ” °º º ¡ » — ¼ º » ¼ ° ý• ͈ �– Ј ½ Ù¸• ½ ¤‰‰ ¾ –"ù” ºà7 ¾ Û ¾ÆÛ üª‰Ž ¾ ù”Óߘ" ¸• ¾ ÛÜ�Š ð÷lÅŠ ÄÛ<òŠ
|
|||
|
|
¹à7æ7 º¸•ù”$Úˆ± àˆ,ƈÞà âä �‰®‰ü£•· üØŽR O This is similar to [`Yoke::map_with_cart`], but it can also bubble up an errorÁ ´¯�©˜ Ê�ú üÒ�\Üà ü³�U R then [`Yoke::try_map_project`] should be preferred, as `try_map_with_cart` placesÁ ü�‘'†Ý ¹‘ú <Á‘ÅÇ ´Í‘ÝÀ ¬è‘¿À ü‚’&�™ ,’æü ä·’ // Implements `Yokeable`Á üØ’+ ( type P<'a> = (&'a str, Option<&'a u8>);Á ˆ“ú l�“¿™ ü¢“)×™ üГ8 5 ) -> Result<Yoke<P<'static>, Rc<[u8]>>, Utf8Error> {Á ü�”0 - y.try_map_with_cart(move |bytes, cart| {Á ü”7 4 Ok((str::from_utf8(bytes)?, bytes.first()))Á Tþ”ïÅ ,�•‚Æ <—•ÅÇŒª• ¦7Û𦢠°¡ À — Á –   À Á ° ½� ¼• ÷ñ ¿• Σ • à م� à ¤ÿ• Ä –"Ûðà7 Ä Û ÄÆÛ ü –’ Ä Ûð�è˜" Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
…� Ä Ûø¢üŒ—& ÄÛ<Ò—
|
|||
|
|
¿à7æ7…�Ûðø¢$Å•± Ë•!$ '* -0 ƒ–¤–üØ í üú›] Z This is similar to [`Yoke::try_map_with_cart`], but it does not move [`Self`] and insteadÁ üÜœ>ñÙ Ÿ�ú ü§�KÇÚ ü÷�` ] [`Yoke::try_map_with_cart`] because it will not clone fields that are going to be discarded.Á Üžú üäž[ X If access to the old [`Yokeable`] `Y` is sufficient to producethe new [`Yokeable`] `P`,Á üÄŸ\ Y then [`Yoke::try_map_project_cloned`] should
|
|||
|
|
ú ü¤
|
|||
|
|
q n With this terminology, [`Yokeable`] exposes ways to cast between `Self<'static>` and `Self<'a>` generically.Á ü– ] Z This is useful for turning covariant lifetimes to _dynamic_ lifetimes, where `'static` isÁ üô * ' used as a way to "erase" the lifetime.Á Ÿ ú d£ ò^ ° ú ü´ b _ This trait is safe to implement on types with a _covariant_ lifetime parameter, i.e. one whereÁ ü—
|
|||
|
|
\ Y [`Self::transform()`]'s body can simply be `{ self }`. This will occur when the lifetimeÁ üô
|
|||
|
|
d a parameter is used within references, but not in the arguments of function pointers or in mutableÁ üÙ; 8 positions (either in `&mut` or via interior mutability)Á •ú ü™[ X This trait must be implemented on the `'static` version of such a type, e.g. one shouldÁ üõA > implement `Yokeable<'a>` (for all `'a`) on `Cow<'static, T>`.Á ·ú ü»L I This trait is also safe to implement on types that do not borrow memory.Á ˆú üŒQ N There are further constraints on implementation safety on individual methods.Á Þú äâ # Implementation exampleÁ ÿú üƒW T Implementing this trait manually is unsafe. Where possible, you should use the safeÁ üÛ_ \ [`#[derive(Yokeable)]`](yoke_derive::Yokeable) custom derive instead. We include an exampleÁ ü»O L in case you have your own zero-copy abstractions you wish to make yokeable.Á ‹ú \�«À Ì› # use yoke::Yokeable;Á ܵüÀ ÔÑ # use std::{mem, ptr};Á ¤ì‘¬ ü� °¬ ì¡Ù¬ ¼¿€ ,×‚Æ Ýú üá3 0 unsafe impl<'a> Yokeable<'a> for Bar<'static> {Á ô• type Output = Bar<'a>;Á ü´/ , fn transform(&'a self) -> &'a Bar<'a> {Á üä: 7 // covariant lifetime cast, can be done safelyÁ „Ÿ
|
|||
|
|
selfÁ L° }Á ºú ü¾- * fn transform_owned(self) -> Bar<'a> {Á üì:Ö’ „§™“ L¸²“ Âú üÆ/ , unsafe fn make(from: Bar<'a>) -> Self {Á üöA > unsafe { mem::transmute::<Self::Output, Self>(from) }Á L¸²“ Âú üÆ/ , fn transform_mut<F>(&'a mut self, f: F)Á lö
|
|||
|
|
whereÁ ü„6 3 F: 'static + FnOnce(&'a mut Self::Output),Á L» {Á üÅN K unsafe { f(mem::transmute::<&mut Self, &mut Self::Output>(self)) }Á L”²“ ,ž‚Æ <¤ÅÇ D½ Ù Ô Ú Ù Ú ã^ü¬¾1 ë^<Ë Ù ã^# ¢™ ã^. ¢™(ÛÜÝÞßÛÜÝÞß Íìë^ Ô Û „± ï™ Ô¾ ç™ „š Þ Ü ß Ý Æ|± üÙS P This type MUST be `Self` with the `'static` replaced with `'a`, i.e. `Self<'a>`Á4¶ Ù Ù ü” + üÇ P M This method must cast `self` between `&'a Self<'static>` and `&'a Self<'a>`.Á œ ú ܤ # Implementation safetyÁ Ä ú üÌ R O If the invariants of [`Yokeable`] are being satisfied, the body of this methodÁ ü£ X U should simply be `{ self }`, though it's acceptable to include additional assertionsÁ |€ if desired.ÁL— Ôë^ Ôï™ Ù Ù
|
|||
|
|
Üë^ Ô$¥ üŠ") üÅ H E This method must cast `self` between `Self<'static>` and `Self<'a>`.Á ’ ú Üš ¢› º ú ü RÓ› ü™!X¯œ |ö!��|�" ë^ï™ Ù Ù
|
|||
|
|
Ýë^ Ô$�"ü§%+ ü¹"? < This method can be used to cast away `Self<'a>`'s lifetime.Á ý"ú d…#ò^ –#ú üž#V S The returned value must be destroyed before the data `from` was borrowing from is.Á ù#ú Ü�$¢› ¡$ú ü©$R O A safe implementation of this method must be equivalent to a transmute betweenÁ ü€%" `Self<'a>` and `Self<'static>`Á$±% ï™ë^ Ù Ù
|
|||
|
|
Þë^ Ô÷$¶%ü©K¿ üØ%X U This method must cast `self` between `&'a mut Self<'static>` and `&'a mut Self<'a>`,Á ¼µ& and pass it to `f`.Á Ñ&ú ÜÙ&¢› ù&ú ü�'_ \ A safe implementation of this method must be equivalent to a pointer cast/transmute betweenÁ üå'@ = `&mut Self<'a>` and `&mut Self<'static>` being passed to `f`Á ª(ú ¼²( # Why is this safe?Á Î(ú üÖ(P M Typically covariant lifetimes become invariant when hidden behind an `&mut`,Á ü«)L I which is why the implementation of this method cannot just be `f(self)`.Á üü)g d The reason behind this is that while _reading_ a covariant lifetime that has been cast to a shorterÁ üè*X U one is always safe (this is roughly the definition of a covariant lifetime), writingÁ üÅ+] Z may not necessarily be safe since you could write a smaller reference to it. For example,Á ü§,c ` the following code is unsound because it manages to stuff a `'a` lifetime into a `Cow<'static>`Á �-ú ô—- ```rust,compile_fail,E0521Á ܺ-üÀ ÌÚ-˜� „ø-
|
|||
|
|
struct Foo {Á ¤�. str: String,Á ü¦. cow: Cow<'static, str>,Á ,Ê.‚Æ Ô.ú üÜ.& # fn unsound<'a>(foo: &'a mut Foo) {Á ü‡/ let a: &str = &foo.str;Á ü«/= : foo.cow.transform_mut(|cow| *cow = Cow::Borrowed(a));Á ,í/‚Æ <÷/ÅÇ ƒ0ú ü‹0d a However, this code will not compile because [`Yokeable::transform_mut()`] requires `F: 'static`.Á üô0` ] This enforces that while `F` may mutate `Self<'a>`, it can only mutate it in a way that doesÁ üÙ1f c not insert additional references. For example, `F` may call `to_owned()` on a `Cow` and mutate it,Á üÄ2^ [ but it cannot insert a new _borrowed_ reference because it has nowhere to borrow _from_ --Á ü§3j g `f` does not contain any borrowed references, and while we give it `Self<'a>` (which contains borrowedÁ ü–42 / data), that borrowed data is known to be validÁ Í4ú üÕ4Z W Note that the `for<'b>` is also necessary, otherwise the following code would compile:Á ´5ú ô¼5«« Üß5üÀ Ìÿ5˜� œ�6·¦ ,µ6æü ü¿6*ëƒ ¤î6‘¬ „‡7
|
|||
|
|
num: u8,Á Ìœ7 cow: Cow<'a, u8>,Á ,º7‚Æ Ä7ú üÌ7/ , fn unsound<'a>(bar: &'a mut Bar<'static>) {Á ü€8H E bar.transform_mut(move |bar
|
|||
|
|
ö û ˆ«E 4 ö û ˆ\Ï¡|àŽ„öeüŒ W|²IüÄÄ ª ý ” þ þ ý ûÈ É ‹É Ì ÿ Ùà7 ÿ ¤ç €
|
|||
|
|
à7 € Û €ÆÛ ü¦" ¶Û\Ñ é!æ7 ,ß ÄÛ<€¦7� � „† ë…üÜ 0 ü�\ Y Construct a [`Yoke`]`<Y, C>` from a cart implementing `StableDeref` by zero-copy cloningÁ üð= : the cart to `Y` and then yokeing that object to the cart.Á ²ú üºY V The type `Y` must implement [`ZeroFrom`]`<C::Target>`. This trait is auto-implementedÁ ü˜\ Y on many common types and can be custom implemented or derived in order to make it easierÁ Ôù to construct a `Yoke`.Á ˜ú l ¢¿ ²ú ¬º Attach to a cart:Á Ôú <ÜÅÇ ÌèÉŒ œ†¸ˆ žú ü¦K H let yoke = Yoke::<Cow<'static, str>, String>::attach_to_zero_copy_cart(Á Ôö "demo".to_owned(),Á 4• ‹Š ú ü¨ # assert_eq!("demo", yoke.get());Á <Ð ÅÇÄã æ7¦7 ü ü
|
|||
|
|
�à7æ7…$ü º
|
|||
|
|
� <closure_kind>Á ‚ <closure_signature>Á ‚ <upvars>Á ‚ ‚ � ‚à7æ7Ã5 ÆÛ à7 Û ³4¬Â g"\â ‰"‰"›"›"ÌŽ DŸ ”Ë µ"üåI# üGE B A type with similar semantics as `Option<C<T>>` but with a niche.Á óGú ü÷GJ G This type cannot be publicly constructed. To use this in a `Yoke`, seeÁ üÂH/ , [`Yoke::convert_cart_into_option_pointer`].Á òHú üöH] Z [`Yoke::convert_cart_into_option_pointer`]: crate::Yoke::convert_cart_into_option_pointerÁ ¬ðI ” Š Š ˆv †J ˜vœ–JË1 »w}ïôÅî ‹Œ ((* ´’L,’L ‰ ‰ ‰‰ § ‹‰ ï íe¼îËè¿*ƒ2 Ì®LL®L ‰ ‰ • • – »8 Fu\»Ÿƒ2(ÝI ” Ž Ž ˆvè ¿cƒ2 †J ˜vö ¿c¸â HË1� Àc � gi Ú Û Ü ÚË1 Û c c ˆ ¢cµ
|
|||
|
|
` £cÏË ` àB¤GS
|
|||
|
|
ÜöÌ � ÝI �
|
|||
|
|
�ƒ2±Üœ üÊR O A cart that can be one type or the other. Enables ergonomic polymorphic carts.Á �ú ü¡T Q `EitherCart` enables yokes originating from different data sources and thereforeÁ üöU R having different cart types to be merged into the same yoke type, but still beingÁ üÌ8 5 able to recover the original cart type if necessary.Á …ú ü‰O L All relevant Cart traits are implemented for `EitherCart`, and carts can beÁ üÙ& # safely wrapped in an `EitherCart`.Á €ú ü„E B Also see [`Yoke::erase_box_cart()`](crate::Yoke::erase_box_cart).Á Êú tÎ¬ß Ýú <áÅÇ ¤éÉÙ üþ! use yoke::either::EitherCart;Á œ ¸ˆ ´ú ü¸) & let y1: Yoke<&'static str, Rc<str>> =Á üâO L Yoke::attach_to_zero_copy_cart("reference counted hello world".into());Á ²ú ü¶^ [ let y2: Yoke<&'static str, &str> = Yoke::attach_to_zero_copy_cart("borrowed hello world");Á • ú ü™ M J type CombinedYoke<'a> = Yoke<&'static str, EitherCart<Rc<str>, &'a str>>;Á ç ú üë Q N // Both yokes can be combined into a single yoke type despite different cartsÁ ü½
|
|||
|
|
6 3 let y3: CombinedYoke = y1.wrap_cart_in_either_a();Á üô
|
|||
|
|
6 3 let y4: CombinedYoke = y2.wrap_cart_in_either_b();Á « ú ü¯ ; 8 assert_eq!(*y3.get(), "reference counted hello world");Á üë 2 / assert_eq!(*y4.get(), "borrowed hello world");Á ž ú ü¢ Q N // The resulting yoke is cloneable if both cart types implement CloneableCartÁ Äô let y5 = y4.clone();Á ü�
|
|||
|
|
2 / assert_eq!(*y5.get(), "borrowed hello world");Á <À
|
|||
|
|
ÅÇ T¥ º ‘ à ’ ’ ‘ ï° Ž€´Ã2 úQö}„$§“”–— ” • ‹3Ã2 — ˜ ‘3Ã2 LN QS §! §! � �
|
|||
|
|
”‹3‘3§!§! ‹3Ã2 � � ÍóÀ � � ‹3ù! ù! � �
|
|||
|
|
—‹3‘3ù!ù! ‘3Ã2 � � ¾ôË � � ‘3(
|
|||
|
|
Ñ
|
|||
|
|
º š à › š › ï| Ž€{ Ø‹3
|
|||
|
|
° Ø‘3
|
|||
|
|
´Ã2œ Ù œ ´· »¾ ŠŒ Ý ÝÃ2 Ã2 ™
|
|||
|
|
Ñ
|
|||
|
|
™
|
|||
|
|
œ‹3‘3ÝH Ø
|
|||
|
|
! º ž à Ÿ ž Ÿ ï[ Ž€ZÃ2 hk or _ c ! º ¡ à ¢ ¡ ¢ ï· Ž€¶ µß‹3‹3 ° µß‘3‘3 ´Ã2£ ·ß £ øû ÿ ïñ Þ ß ÞÃ2 ßÃ2 Ø
|
|||
|
|
|
|||
|
|
£‹3‘3R¹
|
|||
|
|
Y ã
|
|||
|
|
" º ¥ à ¦ ¥ ¦ ï· Ž€¶ ™‹3 ° ™‘3 ´Ã2§ › § ïò öù Š � ¥ à àÃ2 ³4 ¤ ã
|
|||
|
|
¤
|
|||
|
|
§‹3‘3ö(
|
|||
|
|
ç
|
|||
|
|
# º © à ª ª © ï¯ Ž€® ¿c‹3
|
|||
|
|
° ¿c‘3
|
|||
|
|
´Ã2« Àc « çê îñ ŠŒ á â ã áÃ2 â c c ˆ ¢cµ
|
|||
|
|
` £cÏË ` àB¤GS
|
|||
|
|
ãöÌ ¨
|
|||
|
|
ç
|
|||
|
|
¨
|
|||
|
|
«‹3‘35±<øÆ$ Ô ³4®¯°±² Û Ü Ý Þ ß ± ¯ ° ² ÒXù0þ ¬ ¬ ³4øÊ$HÍ ä ä³4 ä³4 Ô Û ¬ × ¬
|
|||
|
|
¯ Ô Øø¦(x© ³4»ÿ ¬ ¬
|
|||
|
|
° Ô ¹ø†* � »ÿ³4 ¬ ¬
|
|||
|
|
± Ô¼Ž •øèthë Ô³4—³4 ¬— ³ ³ ¬ Íì¸� ù ¸�8 ´ –"¸� ´»ÿ ø·$ ´ ¸�Ž‚˜" ³4à¿
|
|||
|
|
² Ô¸� „±Štv »øÆ$ Ô ¶ ¶ Ã4·¸¹º» Û Ü Ý Þ ß ¸ º » ¹ ÒXù0þ µ µ Ã4øÊ$HÍ å åÃ4 åÃ4 Ô Û µ × µ
|
|||
|
|
¸ Ô Øø¦(x© Ã4¥„ µ µ
|
|||
|
|
¹ Ô ¹ø†* � ¥„Ã4 µ µ
|
|||
|
|
º Ô¼Ž •øèthë ÔÃ4¸�³4 µ— ¼ ¼ µ à�ù ò�8 ½ –"¸� ½¥„ ø·$ ½ ¸�ꆘ" ³4à¿
|
|||
|
|
» Ô¸� „±Šqs »øÆ$ Ô ¿ ¿ Ó4ÀÁÂÃÄ Û Ü Ý Þ ß Ã Á Ä Â ÒXù0þ ¾ ¾ Ó4øÊ$HÍ æ æÓ4 æÓ4 Ô Û ¾ × ¾
|
|||
|
|
Á Ô Øø¦(x© Ó4�‰ ¾ ¾
|
|||
|
|
Â Ô ¹ø†* � �‰Ó4 ¾ ¾
|
|||
|
|
à ԼŽ •øèthë ÔÓ4¸�³4 ¾— Å Å ¾ à�ù ò�8 Æ –"¸� Æ�‰ ø·$ Æ ¸�Æ‹˜" ³4à¿
|
|||
|
|
Ä Ô¸� „±Šqs »øÆ$ Ô È È ã4ÉÊËÌÍ Û Ü Ý Þ ß Ì Ê Í Ë ÒXù0þ Ç Ç ã4øÊ$HÍ ç çã4 çã4 Ô Û Ç × Ç
|
|||
|
|
Ê Ô Øø¦(x© ã4Ý� Ç Ç
|
|||
|
|
Ë Ô ¹ø†* � Ý�ã4 Ç Ç
|
|||
|
|
Ì Ô¼Ž •øèthë Ôã4¸�³4 Ç— Î Î Ç à�ù ò�8 Ï –"¸� ÏÝ� ø·$ Ï ¸�¢�˜" ³4à¿
|
|||
|
|
Í Ô¸� „±Šqs »øÆ$ Ô Ñ Ñ ó4ÒÓÔÕÖ Û Ü Ý Þ ß Ô Ó Õ Ö ÒXù0þ Ð Ð ó4øÊ$HÍ è èó4 èó4 Ô Û Ð × Ð
|
|||
|
|
Ó Ô Øø¦(x© ó4¹’ Ð Ð
|
|||
|
|
Ô Ô ¹ø†* � ¹’ó4 Ð Ð
|
|||
|
|
Õ Ô¼Ž •øèthë Ôó4¸�³4 З × × Ð à�ù ò�8 Ø –"¸� ع’ ø·$ Ø ¸�þ”˜" ³4à¿
|
|||
|
|
Ö Ô¸� „±Šqs »øÆ$
|
|||
|
|
Ô Ú Ú ƒ5ÛÜÝÞß Û Ü Ý Þ ß ß Ý Ü Þ ÒXù0þ Ù Ù ƒ5øÊ$HÍ é éƒ5 éƒ5 Ô Û Ù × Ù
|
|||
|
|
Ü Ô Øø¦(x© ƒ5•— Ù Ù
|
|||
|
|
Ý Ô ¹ø†* � •—ƒ5 Ù Ù
|
|||
|
|
Þ Ô¼Ž •øèthë Ôƒ5¸�³4 Ù— à à Ù à�ù ò�8 á –"¸� á•— ø·$ á ¸�Ú™˜" ³4à¿
|
|||
|
|
ß Ô¸� „±Šqs »øÆ$ Ô ã ã “5äåæçè Û Ü Ý Þ ß è æ ç å ÒXù0þ â â “5øÊ$HÍ ê ê“5 ê“5 Ô Û â × â
|
|||
|
|
å Ô Øø¦(x© “5ñ› â â
|
|||
|
|
æ Ô ¹ø†* � ñ›“5 â â
|
|||
|
|
ç Ô¼Ž •øèthë Ô“5¸�³4 â— é é â à�ù ò�8 ê –"¸� êñ› ø·$ ê ¸�¶ž˜" ³4à¿
|
|||
|
|
è Ô¸� „±Šqs »ø Æ$ Ô ì ì £5íîïðñ Û Ü Ý Þ ß ñ ï ð î ÒX ù0 þ ë ë £5ø Ê$H Í ë ë£5 ë£5 Ô Û ë × ë
|
|||
|
|
î Ô Øø ¦(x © £5Í ë ë
|
|||
|
|
ï Ô ¹ø †* � Í £5 ë ë
|
|||
|
|
ð Ô¼Ž •ø èth ë Ô£5¸�³4 ë— ò ò ë à� ù ò�8 ó –"¸� óÍ ø ·$ ó ¸�’£˜" ³4à ¿
|
|||
|
|
ñ Ô¸� „± Šqs »ø Æ$
|
|||
|
|
Ô õ õ ³5ö÷øùú Û Ü Ý Þ ß ÷ ú ø ù ÒX ù0 þ ô ô ³5ø Ê$H Í ì ì³5 ì³5 Ô Û ô × ô
|
|||
|
|
÷ Ô Øø ¦(x © ³5©¥ ô ô
|
|||
|
|
ø Ô ¹ø †* � ©¥³5 ô ô
|
|||
|
|
ù Ô¼Ž •ø èth ë Ô³5¸�³4 ô— û û ô à� ù ò�8 ü –"¸� ü©¥ ø ·$ ü ¸�" ³4à ¿
|
|||
|
|
ú Ô¸� „± Šqs »ø Æ$ Ô þ þ Ã5ÿ€�‚ƒ Û Ü Ý Þ ß ‚ € ƒ � ÒX ù0 þ ý ý Ã5ø!Ê$H!Í í íÃ5 íÃ5 Ô Û ý !× ý
|
|||
|
|
€ Ô !Øø!¦(x!© Ã5…ª ý ý
|
|||
|
|
� Ô !¹ø!†* !� …ªÃ5 ý ý
|
|||
|
|
‚ Ô¼Ž !•ø!èth!ë ÔÃ5¸�³4 ý— „ „ ý à�!ù ò�8! … –"¸� ……ª ø!·$ … ¸�ʬ˜" ³4à!¿
|
|||
|
|
ƒ Ô¸� !„±!Šqs !»ø"Æ$ Ô ‡ ‡ Ó5ˆ‰Š‹Œ Û Ü Ý Þ ß ‹ ‰ Œ Š "ÒX"ù0"þ † † Ó5ø#Ê$H#Í î îÓ5 îÓ5 Ô Û † #× †
|
|||
|
|
‰ Ô #Øø#¦(x#© Ó5á® † †
|
|||
|
|
Š Ô #¹ø#†* #� á®Ó5 † †
|
|||
|
|
‹ Ô¼Ž #•ø#èth#ë ÔÓ5¸�³4 †— � � † à�#ù ò�8# Ž –"¸� Žá® ø#·$ Ž ¸�¦±˜" ³4à#¿
|
|||
|
|
Œ Ô¸� #„±#Šqs #»ø$Æ$ Ô � � ã5‘’“”• Û Ü Ý Þ ß ” ’ “ • $ÒX$ù0$þ � � ã5ø%Ê$H%Í ï ïã5 ïã5 Ô Û � %× �
|
|||
|
|
’ Ô %Øø%¦(x%© ã5½³ � �
|
|||
|
|
“ Ô %¹ø%†* %� ½³ã5 � �
|
|||
|
|
” Ô¼Ž %•ø%èth%ë Ôã5¸�³4 �— – – � à�%ù ò�
|
|||
|
|
â9ç!NµÅÚßåêü°ÌüK Box<T>Á alloc::boxed::BoxÁ alloc::boxedÁ ¬ Û¼À alloc::borrow::CowÁ
|
|||
|
|
alloc::borrowÁ Rc<[u8]>Á o std::syncÁ Option<T>Á Yoke::get()Á https://docs.rs/zerovecÁ ¸Ñ ÃÑ Cow<'a, str>Á úÑ ‘Ò o À std::sync::ArcÁ ´Ò ÂÒ ZeroVecÁ àÒ ¸Ñ .get()Á
|
|||
|
|
Yoke<Y, C>Á ˆÓ úÑ Arc<T>Á ®Ó ´Ò alloc::rcÁ ÍÓ àÒ Ñ Yoke::getÁ åÓ ðÓ ˆÓ Rc<T>Á ‹Ô ®Ó
|
|||
|
|
alloc::rc::RcÁ ¢Ô Ñ ¤ ÍÓ ÁÔ åÓ ðÓ ÙÑ áÔ ‹Ô ¬ £Ò ÷Ô ¢Ô Ñ Œ¤ ÐÒ ÁÔ ÃÑ ÙÑ áÔ ¬ À ‘Ò £Ò ÷Ô o ÂÒ ¤ ÐÒ -Ñ Self::into_rawÁ Self::drop_rawÁ š# ‰ &Yoke::convert_cart_into_option_pointerÁ œ ®[ -crate::Yoke::convert_cart_into_option_pointerÁ crate::YokeÁ À std::ptr::read_unalignedÁ Ú Ñ std::ptrÁ ¾Ö ÑÖ š# ®[ œ îÖ À §× Ù× Œ Ú Ñ ö× �Ø ¾Ö ®[ š# ÑÖ œ îÖ §× Ù× À ö× �Ø Ú Yoke::erase_box_cart()Á crate::Yoke::erase_box_cartÁ Ñ Ù× ×Ù òÙ Ñ Ù× ×Ù òÙ Ù× ŒÑ “ Yoke::map_projectÁ Yoke::map_project()Á ÐÒ Self::wrap_cart_in_either_bÁ Self::wrap_cart_in_either_a()Á Yoke::try_attach_to_cart()Á ¬ Û¼ Yoke::with_mut_returnÁ Yokeable::transform_mut()Á ý Ù Yoke::new_always_ownedÁ Yoke::attach_to_cartÁ ÐÒ .map_project()Á âÚ Self::wrap_cart_in_either_b()Á –Û Yoke::into_backing_cartÁ ‚Ü œÜ Yoke::new_always_owned()Á ÄÜ ßÜ þÜ Yoke::try_map_with_cartÁ —Ý ¿Ý ‚Ü çÝ Yoke::attach_to_cart()Á ßÜ Yoke::try_map_project_clonedÁ –Þ ð# r —Ý Yoke::try_attach_to_cart_badlyÁ ¿Ý Yoke:: wrap_cart_in_optionÁ çÝ ÊÞ Yoke::map_project_clonedÁ ëÞ –Þ ð# r ¡ß Êß 0https://github.com/unicode-org/icu4x/issues/1061Á ÊÞ õß ëÞ ð# �r é! Yoke::try_attach_to_cart_badly()Á ¡ß Yoke:: wrap_cart_in_option()Á Êß #1061Á ³à õß Yoke::attach_to_cart_badlyÁ �á Yoke::new_ownedÁ ¸á ®[ Yoke::try_map_projectÁ ßá ³à õá �á šâ ¸á _ ®[ .https://github.com/rust-lang/rust/issues/86702Á ¹â ßá Yoke::attach_to_cart_badly()Á õá Yoke::new_owned()Á šâ _ #86702Á ®[ åÓ €ã ¹â Self::wrap_cart_in_either_aÁ Yoke::try_attach_to_cartÁ ¿ã Yoke::with_mutÁ † æã Ñ _ Yoke::map_with_cartÁ ÁÔ åÓ †ä €ã ¬ä Ìä ¿ã Yokeable::transform_mutÁ ïä † æã Ñ $stable_deref_trait::CloneStableDerefÁ ç šå ÁÔ åÓ øÚ †ä ¶Û ¬ä ØÛ Ìä ¬ àå ßïä ý P† –"Ñ Œ’æ ÐÒ ç ÁÔ âÚ øÚ šå –Û ¶Û ØÛ ¬ œÜ àå ý ç ïÄÜ ’æ þÜ #[derive(Yokeable)]Á yoke_derive::YokeableÁ à Self::transform()Á àå ßý Self::transformÁ ¤è œÜ ¼è Pßè ý Ùà àå ‰é ¤è ¼è œÜ Ã ý ßè ‰é àå œÜ Ñ Œ«E Ñ «E
|
|||
|
|
«E 4Ñ Ù ï
|
|||
|
|
ÃLð ì Š � Ø™ºã à é æ ³ Œ"�"“"–"Û Þ ã ŒMÃMÐLÇLùMÌìÍì“íµßíß ï ÃLð ì Š � Ø™ºã à é æ ³ Œ"�"“"–"Û Þ ã ŒMÃMÐLÇLùMÌìÍì“íµßíß ïé!ÃLð ì Š � Ø™ºã à é æ ³ Œ"�"“"–"Û Þ ã ŒMÃMÐLÇLùMÌìÍì“íµßíß Ùé! ïÃLð ì Š � Ø™ºã à é æ ³ Œ"�"“"–"Û Þ ã ŒMÃMÐLÇLùMÌìÍì“íµßíß ÙÃLð ì Š � Ø™ºã à é æ ³ Œ"�"“"–"Û Þ ã ŒMÃMÐLÇLùMÌìÍì“íµßíß Ãî «òÅá¾Ý;þÆÏ çà d-Ü8åmpt+ÛTÛlÂø¹3§.wÛÿ‡Ž#‡cáià½Ü³ŠhydÜ=^0,׉fYOÿ%´VmåÌø‹}Â' ŸüûEðx<ÿŒOÞCì}�*‡HOºok|·€ÏÖ‰ÓuG´=ÍS ç´ëwwQ-Úžh oÙÂæHÆI[zÙ»öxQH5!¸Þ³w0ìtò¬žæ8æ [NâCt…T")]Ñþ\%„WiQ; šg—º”l‚g–Jbð¼©�0=rµì†CMÅ o7�|�¼Ô˜˜.(]&™hE^ Æ'¼G¯^eJ ñðõ†R*›#“èñWãî¡ðÔLJ+6+D¬ŒÙHŠã–œi›‘¼�¢Ù¶«.Cf³©µ]öPCƒ�çeÈï–gM‡k,û…·´l º»w¯s]B¼
|
|||
|
|
ó=´}¿eíåtÜÇ®np—(F»
|
|||
|
|
Õ>~ºüäÊKí#BÄÁÈ��6¸³—½Ž^§šÝelr,¸ê´WA…
|
|||
|
|
HA»Ü•¹…Í ¸õ¥ÓWúe¯Êk‚ÿŸ}Ý4,aR"LÖ±Ÿ:A ùóÃ…e¦6he
|
|||
|
|
n£
|
|||
|
|
*œc°À�D$¦A‰êB‚ÙÌ"_B[ ·Ì ›Î©*æµøÓ
|
|||
|
|
ÍY”D¾=hácCö`ÌÖn}² "‹éÛ õ�
|
|||
|
|
Á.æ'GŽÂ=B� vÓkÚ( #KF¿³ »ï™aÓ{ÿU\èJv Më+f`“?ZA©¥1 Îý›—5ËY^YzåÏægEF¿Ùi¶èš¸KŠ‚¢88ÙÙ ?"$iƒô)Iعž
|
|||
|
|
lRŒ ^ï3
|
|||
|
|
k0ʽyµâœã÷K –t�J¦i Õ
|
|||
|
|
›LœS"¿œô™)§o¶™ ´47 ø9}u6�$fÞÎÉ
|
|||
|
|
'ðć^�#d‹ž«½’Ch ÃÎ…í,=WÔ8sŒ¤�Tr’3-Ö‘J
|
|||
|
|
!�.?ªÅì–„4{œ�µÜt9’¢˜F&íO�s©;Š Ý{’DÙmTAoJŠ†ÙpŠp�)c$b=»jŽtûª� m€nNãöxâÀ�ˆyõO_Õ$ý)„DêX„qÖé¦ÜÖã\®|=©"mÔì…/�Î� "ù+pȦ”Yɬ“ÇTrbm-ehù¾te½œ{û\F�qÕ6Æ� Ýä±B(©ÈâP„Ú›‡dñBvAELµi߃Ílo€£BêÃ"C¨ sEÇb ¶ÀæeP#Onµ‘Háù¢�zïš¹à J«¼û²#éŽ;M<´O]ÖÝZÍâX�[ƒÊÿë;Dãþ˜â¸µ#h
|
|||
|
|
ð®°ÞÔø¶ŽýL6¨EE5$d�Î116áþmygd ÌÇs:$øg�ÐF�' ññðO©ôïÜ;BßLS–h³Ç£‹7ÏÔH m´Ã*xƒã’bf¹/N ªòzŒÂ/ ðsâmW´ˆ¦ð�v5ŸÉ…+PÈ¥¸ŒÏ½Fwɇ¢Š¶Èœ�šjàJñ‘†Ì, Ô;£heÀ½z·ê¤’uDÚàÌ¢¦ç0›ŒT=‰~�ùÛ¯QåU?¹Rd§ƒƒ°± ¯ê{ WÞøÝ‹û+<ï ðÍsA<œä6Ô{©"ôGb�Œ©$ÝÓ®„„à¿ÏöW7Ú�V<ȵŠ8>ý/ŽÖ;Ú
|
|||
|
|
ÿõÿ*õjÞšßG†[–h#¿Ç·)N€ë 3bwtk±Ú¦
|
|||
|
|
ßY‰`FÉ´ÆgçÈiÿ`L2_… jÒYÃK+ús¢¥ûíP¨Øf$kQÛ ÈcŽnÉ „êÛ&«q×qLLé©ÑCÅœÉC*‚hN†Œñú~4$Ü»Ad‹!™û1q#ø… Ñ�ä‹ÉÒWž�a�š4ÀñØý[Þ�]Ï ÝqÅç -»Æþ$®=•‰ž½”·ÅBjëÄ@eqG;j¾]qÎoRá¶?q=ÔåBf^¼ý”jÉ–'\–/³†>Lð 9,êbQG¶E³ ±†fîÒ·'ÁÆG ‹ö,Í æd¢ÂJ Iï²o_ýä»x¦ÅÚ*ý×û¿Ð T¥fúͼ¡ á5é¯9¢¦O"ÛHsMqP! �µ:Ð>ØçPO�ÈïMC€lRYAW«÷_ÜgçP�ºf KÍ´•^BãÆàÑ&èKÀöʳ"±Žï×ô³–ÏÔ`Å a\´þKɘÃ@§[- ½5¸¼ì?[e [Î
|
|||
|
|
Yv–ôì³Æãƒ'GߘÄãø ^8x²îE=X¥Qoñ"j?¾Ëz"sB{èøòžQí™»ÒluÃcI
|
|||
|
|
NŒ7®u‰ôéùåŸöN£QC ƒ+÷yý´A�ø\ZT86 #¥eSHœü¦�½ÒZì*ûsÆ~¡r àÎ�Èêä´ç§«tÓ,jC°‰Ô�ËÀƒîãI¾ZÑ †@¨7Aì ÂoY^¥–S_P½üOª—¬”É|Ù$°Ì6žßù•ðò¤ršùüGzÝÅäå‚‚)93‚Y¯×¢zs ²…WÅ¿cuÕÆŒ“?Ö’1Fj> ¨•8)””8vdüWÐ ûÝ;o¿îÄömºCš.i uOü3£‹²
|
|||
|
|
ƒ 1ç; ¿\ìwòáÔ¨ IÉÙà‹NTnºÔo^ì¶î5Ü {Æ�Ifža Áü 3‘]Õ‹C«s�šc4ßáÓMS JùX±ßÀ›ª•wדêÃÕ�ýÍÝ1 ¨‚Wgž„×cò"q_C€†üLùÔS‡“‡¯8}ßè!ÿ=Öj¶œ.úCè;�D&lcõt¢ Û$jm4·|c› ¾«6)SâËO2R?À]”jÔI˜´o+97s©Q7U]k?ù¨&Ä2hâ?f”…"À<â6Žsô ¬Û�<-F Ô°åqÉ–35œ\îu)³P¼õ;§Ÿ7”}*ÏñÉ1=gø!Twf'ž2 ÁõËcÿ wŽ¼j¶�ÎiŽ«¼y Ju>ûq¤‡]l r™\%¾KŸ´})»fÎ×›®8 ä5E^�šª‹ß°åJëPû
|
|||
|
|
á¯5 |"¼ È*]©F•Ìaû¾íGϵå¢qE¶îÀº¹P“P†¾~a;_‰r —‹?KÜ`´õQÚÅL”¨…úØËòD¢í¬tÃN>^q‡¨p |«U:³Ýx4rðno<³î®ÿ†j‘ ³—ÆÚ_¶#ý† åÛÿ#?÷•¤ábh¦Ñ~Ö†tK˜ÂÝjN2Le¸Ö.HN;²á»zÝX'_4TwA>ʉ1\“˜ÝËÅ ÐÁôMǺTÆõñž5Ò0(" ÌwZú¥Ýª\&ìÎÝRÆMj®›ÑÆõè°Bw·U9‚r®îm3K>ƒ@æ÷/ýð‘³BÙè$Dv¦ÃŸó5ysxÎCD*[“«óóHªþJìgêëÆ};Û$ ã™ ;ì�ÆƲµüî56OŒÉ#w
|
|||
|
|
¾ ¶§5J^P€Ùó hÅ ‚ŒTÿϼF²î“x”(ä$«÷ã/u³A�€9òF?Ö!¦x‘:žxßj©V€ 6èö
|
|||
|
|
ÒµHÚzI;ÚÙ´ÞK[ÕpAøŽÂÓæÒ¯~'•=Ø‘T¥õ_?¡f”! ®�Ãdêểϖ!Â*ê{ÂdUóß’a‚‚!k›DЉQVá‰þž' h¹äEŠÇrÆÎ
|
|||
|
|
þá Œ½´Ôò‡µq\ òÜ…Á/D�Nê† ºüo‹‰ã(4×À—<ÙÃ[kî¶LL‰.ŒóY ³MjÔü5iíSÓ‹†&!3ùV
|
|||
|
|
²Œh ÂíÓ.Dº.eƒuI¶ö�yv¤’‰az#×´YOp LJÐÚI •‚ž‚ê±KÆ$’Qv³“q©ÞGȳú—uÛr�z挩šüGaQºM1ŽÄµÈãvñr¦JUƒG̶Öz¨«ý� þRüÍ:œ®¦–—âW¼
|
|||
|
|
ØyŒ¸õSº%5R¢µ•å�æ‚tB+Ç®a|[1œ:å
|
|||
|
|
Kw±XoÐg¾VO æè¾düªƒÜPƒnDk{ïÍt*3ôJB/²
|
|||
|
|
‹‹h×Ñ$³);Š„[hÐx‡}©Ò‹Âà-ÃÏ—F–aQ´ë>‹ÎAéð¤wo�öuÉÞ° qhE>ÃÆF¨á¿Ì@6e™'_�Æ1Ìü…‘ìnðØ•� äI„·Çp*ÊùwX ü‘æOʇ pƒ—v¥¯I¸,åže (žœÛÒO7•µQGu.ôýÚ³/½ìãú¹Fדb™x’
|
|||
|
|
.cì9ÖP/¤ØG‹�ÊRG(o!C�F0 q ‚jÓ—è´§Üḽfxñ¯¤u”!ªÒ®²êœß3r8 ÜÈyL1%·C( v|é’è»A '�éŸÜP¡DiÉ.UÑæ é`‚AÁ`Y² û…¹™zXìQµßÂm?
|
|||
|
|
`ná9 ’ô��é2 �Ÿ
|
|||
|
|
’½LôìiV‰PYÿ„R¼Ý±?L
|
|||
|
|
fÓÕ �ÞÚL…s3`õs£ÛmŽrc„´ ¹Åþžõ^5†“LnfY3ÕN.ÁíÂk_×rN5Èw!�’2)þ Àë‡`¥ Žj—‡,Ýž/°´$§#ú±Có@UDËØ¥§ÌÎ^v¸ËMÆ»5ùñN û©ï´™ÛGe™W[Æ=¾[È, „Ú€VkQŸò´ Ü¢kš…$ÇK¶ý©³O;_j\„3¾5 vüh CH» ‹ØT!ñ�i†ES`²ìˆu˜` ôædˆ´‘�q³
|
|||
|
|
Ïè´Q ˜ž§ˆÎñWóùVªdÛ2 ÞÇï¥@,ÌW°> tÑD M7ÑÛØ2á<¿ g
|
|||
|
|
)àÓƒaS많¨'UNpV F…³HySÅ[ZAa=5ßx¹�zŒH¤&¾îëT0A×âÀòõ’½aÓz%|l ²Üi–ÒbpuŒP” ™NpøZ½7rÊ�Â|o)˽ RŽm¿ÿÊ{ε;| 7ü¸ñý¨/0·^úkK¼],%•ãøŒ#ˆHnã2' ðÖl[$^ü¸Ë�߇š\¢úU«ìwÓz¯sËZTvL·MX®/™ˆóq™‡û8…“QÍ @ó2£Ð k·hL¼�ùÄ$¦Œ‹²N &f4}Àô ܽN Q.}ÓÒ÷—u3/ÃÈãr~CèöU
|
|||
|
|
ÞУX�¹ÐóÉž¡üYÙT=3 Àò¾Ó<šTžÖ@Ä$ë\6ßà <Üü×ä©biÑÓùE mËÂ`Ü�þÔ7Ôrnj®ã w„Á±Ì¬á>ôÁ옴¾ë™RÜ¡ÍlŽŸîš6ñËÃX†5 r ‚i¼`Ã1îD%’v@ÄýŽ¸þ` À)Z-~E¹@ĉZ€^�pøÕ3µÔwy^à×Ë(àé\z<Þ‡© „Ó,`…š•æ‘Ÿ÷Ì~d2ÝRк�fGz{Ž{ «K=íUŒÍV•DÖ¬x× ÉÞ°™S±BöBrò±½°`�ZÙ@!dÀHßbþ Eélo2p|Ì÷¬0Édü=· èBŽõîeÀœ¢šg
|
|||
|
|
?�<Wg
|
|||
|
|
“•&Ú†ú–¯yÍ)$®8ãs|7Rq•…½‡SáL[jf‚/ÜÞÃ@F3)ìù2°?”@}ª˜±9nóOªèbÑæ~™’\¼l{pqÇYî| ¤{íDa•ÉMµ²ã\¥]bJWq|2IU]v©.o�*oÿ6
|
|||
|
|
]‹¢ ô·™Î’¾þã–F•ÞËŒ¬<KÖõ šýÊY–aÊp›¼¯/TºÛGS, uðY4lˆXÈ ÌsŒ@µ^Sk ´¶Lè�]¬Á (-_]yµµt¬R<¢CÆèKßw ¯^ħ”jòÊEÉx†„ušhŠˆ‰˜wÈTã^… xA‡³ e3Ó !eÞºîÆU³‚©(Œ\8¿œÍ0�óm‘® ÞR�/DƒÌ‹›ùÚ•>àka&T*ÖW@¨äŸ`ÂZÃ/…y~jÚ¸†‹2+d5éu`<M /›ñ�>s9h7 C!©Èùt‰Â'™ª>©,±º� ÈúÚ‘º
|
|||
|
|
ý ã7³ì›�_æŨté‘ö™ç üV„ÄÓ²e[ºu(å>ž—„ ˜`y—Xâç™åâó¢UYT æaÙ-ÔªîL+©ì$ÅÁÚ� R§¥(£M©ih?¡ˆ
|
|||
|
|
Õå&å©
|
|||
|
|
¥G¡WLñ ™á/I“3ö<Í1«H�†üØ+¸ãELÅ«&-Æ:£ë9¸µHU hR ^ÂU¹YvÀsB�¹|+I–²¾ðFgÜ6³�¼ëpxË°£y͹½,æz”±o ’¤ÁŸù^î”›‘òæˆoFa}BCŸÊ2hÄ.ÜðÇÒZÎKòÇÕ~‰ñ^¹h'œ3x؃¶Šöc?{æ$ɪ(oÇ%�à7ºŠ•Ä Ü1RÆuÁõßVBla ›Øjä$LNfË–ŒÔ·1Ô$‘®‰4 ”G3† ©²X{M }¨Ð_i’/`= Ä*Ñ+bL¹ lK=¿&…¬X§'�y7]5Óv¶G4#QªÉè´¹þ"à6ej§€/è=•a©æ£‹<8Rž)7Æ0´z;šÿŒròôïjc—µ†–ñýy[—V³â8êÌ«¤UpR ¸î IÃY†ôòþïá§7#ÑÚ:ÕŠaÎ ßC§ÂÛ 4ïHŸ%(`õx “2 f ©2 ’ / n2 _7
|
|||
|
|
h h * ]- ¦> …A 9E yT = V ¦ý )
|
|||
|
|
5 7 W 8 ¤ 8 ü 8 9 Š 9 Û 9 ' : p : ¿ : ø : B; _ < ¡ < õ < > = ’ = Û = % > m> ù > Ú ? ñ ? \ @
|
|||
|
|
A | A B ] B v B µ B ù B ; C „ C › C ù C = D › D Þ D 1 E ¥ E I H J T Q ô Q ^ R \ S ’ S R T p T ± T + V �8W w d ’ d ¯ d p e © f [ g h Î h A i è i j ¹ k k l à l ‰Dm ¹v |y ±z | — | †N1‚ ‰ |>� i › ’ž 5 Ÿ ÕŸ h£ ˜ ¤ ¥ 㧠[ © ï.© ¦ ± 5² Z³ î · 5 ¸ ‰ ¸ œ ¸ ß » > ¼ ÙA¼ UÈ ¿;Ë ÇÒ ÈÕ yØ ÊÚ fÝ : à Û^à � ì "ð © ô ² ø :ù �û X ý o ý † ý œ ý ÛLý ½ 2
|
|||
|
|
ø ä
|
|||
|
|
¬s " $ ¥ $ ¿ $ % c % ¯ % � & ' - ' “ ' ß ' - ( ) á ) ·* ñ - À. v 0 Ä 0 1 i 1 $2 9 9 ” 9 ª 9 : : ¤ : ü: X; è ; X< ß< P= × = � > é > ? z ? Å ? @ ú @ S A o A ä A / B | B V C ¯ C Ë C @ D ‹ D Ø D ² E F ' F œ F ç F 4 G H g H ƒ H ø H C I � I j J à J ß J T K Ÿ K ì K Æ L M ; M ° M û M H N " O { O — O P W P ¤ P ~ Q × Q ó Q h R ³ R S Ú S 3 T O T Ä T U \ U 6 V � V « V W k W ¸ W ’ X ë X Y | Y Ç Y Z î Z G [ c [ Ø [ # \ p \ J ] ¢ ] ½ ] 0 ^ z ^ Æ ^ Ÿ _ ÷ _ ` … ` Ï ` a ô a [ b ¨ b ö b Ò c = d Ž d à d À e . f ‚ f × f * W- Â.
|
|||
|
|
/ Œ2 s7 ¤> „A 9 E xT 3V ç · ¤ý Q ) î8
|
|||
|
|
/ �2 t7 ‹ 8 Ï8 : §: †< #= È = > [ > Ÿ? Ý @ ] A IB žB cC !D ÃD ¤Q ùR úS Nd 9e $g –h ¼ i hj 4l Vm
|
|||
|
|
² ç · ! ¸ n ¸ • ¸ ¦» ˜¼ ¦à ù [ Z$ È& ˆ* _0 L1 þ8 9 x: 7 ; »; ³< «= ©> A oC ËE 'H ƒJ ßL ;O —Q óS OV «X [ b] ·_
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
+++
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|