82 lines
28 KiB
Plaintext
82 lines
28 KiB
Plaintext
|
!<arch>
|
|||
|
|
/ 0 0 0 0 4 `
|
|||
|
|
/ 0 0 0 0 16 `
|
|||
|
|
žg // 70 `
|
|||
|
|
scopeguard-fed636edc3fb0fc5.scopeguard.76ddd565be7330d7-cgu.0.rcgu.o
|
|||
|
|
lib.rmeta/ 0 0 0 644 26187 `
|
|||
|
|
d† 5f .rmeta ùe < rust
|
|||
|
|
[d #rustc 1.95.0 (59807616e 2026-04-14)ÁûKn�c8’ÞIK/�%W -7c4a4c66f69609a4Á ²B÷è:£¢¬-Y4^ˆ&8ö -c5c18940a57badd0Á‰ OnUnwindÁDÀ6 Í use_stdÁœ�6 OnSuccessÁLà7 Ížœ°7 defer_on_successÁ„§? Ížœô> defer_on_unwindÁ|²B ÍžœÿA guard_on_successÁ„”[ ÍžœáZ guard_on_unwindÁ|öb ÍžœÃb testsÁ,¤n ö $™n û º StrategyÁ
|
|||
|
|
should_runÁ
|
|||
|
|
¾ deferÁ
|
|||
|
|
ScopeGuardÁ TÁ FÁ SÁ ® dropfnÁ strategyÁ ÷ ÿ ‡
|
|||
|
|
with_strategyÁ
|
|||
|
|
into_innerÁ guardÁ ÷ ÿ ÷ ÿ ‡ $÷ $ÿ $‡ $ò $Ã *÷ *ÿ *‡ *Å /÷ /ÿ /‡ /ð 4÷ 4ÿ 4‡ 4á AlwaysÁ :á )
|
|||
|
|
.
|
|||
|
|
3
|
|||
|
|
8
|
|||
|
|
8
|
|||
|
|
8
|
|||
|
|
;
|
|||
|
|
;
|
|||
|
|
;
|
|||
|
|
Åb 9 {LüŽ]Ÿ” è Ä æ ® – £ ')Ð˪® ÷ÿ‡ ¢!� ¯!� Å!� Åb� : 94
|
|||
|
|
9 $ * / Åb#
|
|||
|
|
Ä ¢!¯!Å! (›5 ; £…¦… §…¸ ¨…ú ©… ª…Œ«…ú ¢ÈŸÙ6�Œ ŠŽŠŽ‹Ž ErrorÁ …Ê:{KTiP ˜ è ¢ ¦b¦b • ¨b°
|
|||
|
|
¦_ ©b bufÁ¦_ üØ ÷Qy¬j è ñ ¹þ $Å8 Ï8 ü£8, $¶8
|
|||
|
|
¤¡M ÍÑ4{ …È| ª¡ Ë ý»41{ –¡ Ë
|
|||
|
|
ë4{ ÌËM Q N ª¡ Ñ K –¡ Ñ G ü�M‘ ËÑ× ÷ É É Ê PhantomDataÁ Ô²ÑæÊÜêd ×× ‘N ˜N üºLÞ ýƒ4o{ ÊË2 ýÿ_| íË?+ ÊÑ ' íÑb � œãL Ë ÏL Ñ 4ÕL –¡–¡ ManuallyDropÁ ˜¡®º „ ð«0ÇË9MË Í –¡–¡ Å ˜¡®º „ ð«0ÇË9MÑ µ ª¡ª¡ «¡
|
|||
|
|
MaybeDanglingÁ ¡úç ¼ß° +‹ÉË Iª¡ª¡ «¡È ¡úç ¼ß° +‹ÉÑ ‡ vÁ –" œ L‡U Ä Â ª¡ � À –¡ � ½ ýÓÑ%† ª¡ª¡ «¡È ¡úç ¼ß° +‹É� � ¹ · Ë �åR{ Ê �þ ‚ Ñ ýÒR'{ Ù
|
|||
|
|
ðÑ E #
|
|||
|
|
øR{ öW ÷W üâS• üƒUô üÊU§ Ö Ê�Ä“U Ô í�ýâT9{ Ó�\âU ýã 8| î�E�U{. ÓËdáU * îË&ý›¿å† ŸËÄÖU ýêVE{ Ö�dÇW ý¨ D|
|
|||
|
|
ï�E¡W{
|
|||
|
|
ý‰Pø{ ÏÑü¯W% 0 ïÑEðR{ Ë „T � ,ôS –¡–¡ Å ˜¡®º „ ð«0ÇË9M� f ²
|
|||
|
|
k Ê 1 Ñ Ü ð^ ð— ®,ÎU — Ìê
|
|||
|
|
‡ † „ ª¡ Ë ‚ –¡ Ë } ´ ½ ª¡ Ñ É –¡ Ñ Æ € ËÑè m É É Ê ÷ Ô²ÑæÊÜêd èè s z âY üÞX„ | ËÑèü¼Y$ Œ ÊˬŠ íË´² ÊÑý° íÑ´ æ ® – £ ')Ð˪®ËÑè Ä…Y Ë ñX Ñ 4÷X ¹ ¬þ ý· ´‚ ´ Ä5 –9
|
|||
|
|
=Ž | ¹ · Ë ¾g ) üŒg2 À ÓË\g ½ î˺ Ë Ÿg � ,•g X ]Û | ¹ · Ë âh . ü hB ë ÖË\Ñh è ïËå Ë 4»h � Lh X Å ¹ · Ë Þ þ ‚ Ñ ,Õj 4Üj |±k
|
|||
|
|
m
|
|||
|
|
× # ) 4Ïk lÏk ,Ök
|
|||
|
|
|
|||
|
|
|
|||
|
|
*m
|
|||
|
|
Ò!ÑË Y K S Ûk
|
|||
|
|
æk ìk
|
|||
|
|
ík ) ) 6 > 3 üÀi üÐj� . ÓË\ûj + îË( ŸË¼ðj g ÓÑd”k d îÑa< ŸÑĉk ²
|
|||
|
|
Òi Ó LÈi Ë Ò Ñ Ç Ë f Ñ 4 É ²
|
|||
|
|
‡ Ñ ¢ Ý — Ë — P ®& – ê Ô ÛÑnËt ü£m& m
|
|||
|
|
ýb £m m
|
|||
|
|
°²m ü¥m$ J dæm ¹ · Ë " Åb ü£mP m
|
|||
|
|
ß_ °m Æ#<Ým m ä×m òm ü£mf m
|
|||
|
|
æ_ h D�n Žn �n 8 üäl« v ÓË\çm s îËp ã \�m ¾ ,ël ñ
|
|||
|
|
òl Ó_Ó_ DebugStructÁ Ö_á»_ ×_Š »_ Ø_
|
|||
|
|
has_fieldsÁ»_ ÿÖ!½¢—ÑM > ƒ& Û …& ã ˜$ ” ² ¸ š ¹ž ï ®# ² ˜$Í µ$• ‚%N 9û º Í0 á Ü0 ¦_ ÷ \ò0 É ÷ Ê Åd�1 –¡ ,ª1 ¢! DerefMutÁD±1 ¯! ° Å1 ž
|
|||
|
|
Ú,±< ü ò… ütE B A scope guard will run a given closure when it goes out of scope,Á üº$ ! even if the code between panics.Á üß$ ! (as long as panic doesn't abort)Á „ ˆ tˆ # ExamplesÁ — ˆ ”› ## Hello WorldÁ ® ˆ ü²@ = This example creates a scope guard with an example function:Á ó ˆ <÷ ```Á äÿ extern crate scopeguard;Á œ ˆ d fn f() {Á ü0 - let _guard = scopeguard::guard((), |_| {Á üÞ* ' println!("Hello Scope Exit!");Á \‰ });Á • ˆ ü™! // rest of the code here.Á » ˆ ü¿O L // Here, at the end of `_guard`'s scope, the guard's closure is called.Á ü�M J // It is also called if we exit this scope through unwinding instead.Á ,Ý }Á Œã # fn main() {Á lõ
|
|||
|
|
# f();Á <ƒ # }Á <‹ ƒ+ “ ˆ |— ## `defer!`Á § ˆ ü«< 9 Use the `defer` macro to run an operation at scope exit,Á üè? < either regular scope exit or during unwinding from a panic.Á ¨ ˆ <¬ ƒ+ ü´0 - #[macro_use(defer)] extern crate scopeguard;Á å ˆ Äé use std::cell::Cell;Á ‚ ˆ |† fn main() {Á ü–Q N // use a cell to observe drops during and after the scope guard is activeÁ üè( % let drop_counter = Cell::new(0);Á L‘ {Á ü› H E // Create a scope guard using `defer!` for the current scopeÁ ¤ä defer! {Á üù 9 6 drop_counter.set(1 + drop_counter.get());Á l³
|
|||
|
|
|
|||
|
|
}Á Á
|
|||
|
|
ˆ üÅ
|
|||
|
|
: 7 // Do regular operations here in the meantime.Á € ˆ ü„ 9 6 // Just before scope exit: it hasn't run yet.Á ü¾ . + assert_eq!(drop_counter.get(), 0);Á í ˆ üñ K H // The following scope end is where the defer closure is calledÁ L½ }Á üÇ * ' assert_eq!(drop_counter.get(), 1);Á ,ò Î. <ø ƒ+ €
|
|||
|
|
ˆ ì„
|
|||
|
|
## Scope Guard with ValueÁ ¢
|
|||
|
|
ˆ ü¦
|
|||
|
|
J G If the scope guard closure needs to access an outer value that is alsoÁ üñ
|
|||
|
|
P M mutated outside of the scope guard, then you may want to use the scope guardÁ üÂN K with a value. The guard works like a smart pointer, so the inner value canÁ ü‘5 2 be accessed by reference or by mutable reference.Á Ç ˆ üË ### 1. The guard owns a fileÁ ì ˆ üðO L In this example, the scope guard owns a file and ensures pending writes areÁ ÌÀ synced at scope exit.Á Ú ˆ <Þ ƒ+ äæ “+ ƒ ˆ œ‡ use std::fs::*;Á ü› use std::io::{self, Write};Á ü»9 6 # // Mock file so that we don't actually write a fileÁ ´õ # struct MockFile;Á ¬Œ # impl MockFile {Á ü¢B ? # fn create(_s: &str) -> io::Result<Self> { Ok(MockFile) }Á üåE B # fn write_all(&self, _b: &[u8]) -> io::Result<()> { Ok(()) }Á ü«9 6 # fn sync_all(&self) -> io::Result<()> { Ok(()) }Á <å Œ/ üí! # use self::MockFile as File;Á � ˆ ü“% " fn try_main() -> io::Result<()> {Á ü¹- * let f = File::create("newfile.txt")?;Á üç1 . let mut file = scopeguard::guard(f, |f| {Á ü™6 3 // ensure we flush file at return or panicÁ üÐ! let _ = f.sync_all();Á \ò Ç, üþ9 6 // Access the file through the scope guard itselfÁ ü¸0 - file.write_all(b"test me\n").map(|_| ())Á ,é Î. ï ˆ |ó ò1 äƒ try_main().unwrap();Á , Î. ¦ ˆ <ª ƒ+ ² ˆ ü¶8 5 ### 2. The guard restores an invariant on scope exitÁ ï ˆ <ó ƒ+ äû “+ ˜ ˆ üœ use std::mem::ManuallyDrop;Á Œ¼ use std::ptr;Á Î ˆ üÒD A // This function, just for this example, takes the first elementÁ ü—A > // and inserts it into the assumed sorted tail of the vector.Á 4Ù //Á üàK H // For optimization purposes we temporarily violate an invariant of theÁ ü¬- * // Vec, that it owns all of its elements.Á 4Ú ÅG üáJ G // The safe approach is to use swap, which means two writes to memory,Á ü¬R O // the optimization is to use a “holeâ€� which uses only one write of memoryÁ üÿ" // for each position it moves.Á 4¢ ÅG ü© > ; // We *must* use a scope guard to run this code safely. WeÁ üè M J // are running arbitrary user code (comparison operators) that may panic.Á ü¶ H E // The scope guard ensures we restore the invariant after successfulÁ üÿ + ( // exit or during unwinding from panic.Á ü« . + fn insertion_sort_first<T>(v: &mut Vec<T>)Á ÜÚ where T: PartialOrdÁ ,ö {Á üü struct Hole<'a, T: 'a> {Á ô� v: &'a mut Vec<T>,Á ̼ index: usize,Á üÖ # value: ManuallyDrop<T>,Á Lú ©7 „ ˆ „ˆ
|
|||
|
|
unsafe {Á ü™ H E // Create a moved-from location in the vector, a “holeâ€�.Á üâ ) & let value = ptr::read(&v[0]);Á üŒ!T Q let mut hole = Hole { v: v, index: 0, value: ManuallyDrop::new(value) };Á á! ˆ üå!. + // Use a scope guard with a value.Á ü”"G D // At scope exit, plug the hole so that the vector is fullyÁ üÜ"! // initialized again.Á üþ"U R // The scope guard owns the hole, but we can access it through the guard.Á üÔ#A > let mut hole_guard = scopeguard::guard(hole, |hole| {Á ü–$S P // plug the hole in the vector with the value that was // taken outÁ üê$' $ let index =
|
|||
|
|
Ú bĸ0 rD×0 „Äå0 —´ƒ1 ½ÜŸ1 ÐÐëëDÀ1 þ”‰2 üË1= : Controls in which cases the associated code should be runÁ D“2 ä³ ü‰2« Úf Úf Äš3 ü¢2= : Return `true` if the guard’s associated code should runÁ üä21 . (in the context where this method is called).ÁT�3
|
|||
|
|
âfÄî7 è ¼£8 T¦8
|
|||
|
|
|
|||
|
|
|
|||
|
|
”¤< üó:0 - Macro to create a `ScopeGuard` (always run).Á ¤; ˆ ü¨;? < The macro takes statements, which are the body of a closureÁ üè;+ ( that will run when the scope is exited.Á (|”< ·< Ž= ½< Ç< , ¾< ¿< Å< , À< 8 tÁ Á< & Â< 8¢ Ã<
|
|||
|
|
Æ< *É< Ì< ‹= 8 Ö< 8 _guardÁ 4Ú< á< , ã< 8 ,ä< 'é< 8ð ,ë< ð< „= ñ< ò< $ ó< õ< ö< ÷< ø< ú< ƒ= , ü< ý< €= , þ< 8˜j ÿ<
|
|||
|
|
�= % …= % Œ= üðG' ü¦CA > `ScopeGuard` is a scope guard that may own a protected value.Á èC ˆ üìC= : If you place a guard in a local variable, the closure canÁ üªDN K run regardless how you leave the scope — through regular return or panicÁ üùDJ G (except if panic or other code aborts; so as long as destructors run).Á ÄÄE It is run only once.Á ÝE ˆ üáEI F The `S` parameter for [`Strategy`](trait.Strategy.html) determines ifÁ ô«F the closure actually runs.Á ÊF ˆ üÎFM J The guard's closure will be called with the held value in the destructor.Á œG ˆ ü GO L The `ScopeGuard` implements `Deref` so that you can access the inner value.Á TûG ÷ ÿ ‡ ã³Ë †H ã³Ñ ‰H ã³× TŒH Ï!ÑÝ L¥H ÑÝ Ñ! ²
|
|||
|
|
× D·H � ')Ð˪® 3rt oq l ŒH è ´ÇH ,ÇH ¹¼ãH 4ãH þüÔI! DÔI é
|
|||
|
|
üúIJ ÷ ÿ ‡ ÑsL©J Ÿs ‚J ¯s …J ¿s �s ÿI ãsD»J � 24 8: üºL< üËJL I Create a `ScopeGuard` that owns `v` (accessible through deref) and callsÁ üœK& # `dropfn` when its destructor runs.Á ÇK ˆ üÏKH E The `Strategy` decides whether the scope guard's closure should run.Á .\ªL lÁL ËÑ�
|
|||
|
|
ËÑ×Ä*–3üâS# üžNM J “Defuseâ€� the guard and extract the value without calling the closure.Á ðN ˆ <øN ƒ+ ä„O “+ ¥O ˆ üO( % use scopeguard::{guard, ScopeGuard};Á ÚO ˆ üâO% " fn conditional() -> bool { true }Á ŒP ˆ |”P ò1 ü¨P= : let mut guard = guard(Vec::new(), |mut v| v.clear());Á ´êP guard.push(1);Á …Q ˆ Ô�Q if conditional() {Á ü¬Q3 0 // a condition maybe makes us decide toÁ üäQB ? // “defuseâ€� the guard and get back its inner partsÁ ü«R6 3 let value = ScopeGuard::into_inner(guard);Á „æR
|
|||
|
|
} else {Á üûR0 - // guard still exists in this branchÁ L°S ©7 ,¾S Î. <ÈS ƒ+TéS �Ë
|
|||
|
|
ËÑ×ðœ
|
|||
|
|
üÞXW üûWL I Create a new `ScopeGuard` owning `v` and with deferred closure `dropfn`.Á .\ÒX ,åX ËѨ ÷ ÿ �s ëX Ÿs îX ¿sL«Y Ñs
|
|||
|
|
ËÑÄø –
|
|||
|
|
/1 57 ü®eg ÷ ! ÿ " ‡ # ! " # ÑsLúe Ÿs ½e ¯s Àe Ä Ë $íe ¿s$ �s ºe ãsDŒf � =? CE ü›fT ÷ % ÿ & ‡ ' & ' % ÑsLÔf Ÿs £f ¯s ¦f ¿s �s f ãsDæf �() £! ¤! ) =? CE \öf 4ûf $ $ ˬŒg ,�g < <� <Ë $ •g $
|
|||
|
|
)ËÑ×$–g üÂgW ÷ + ÿ , ‡ - , + - ÑsLþg Ÿs Êg ¯s Íg ¿s �s Çg ãsD�h �. °! . 79 =? ü h! L£h = =� =Ë * h *
|
|||
|
|
.ËÑ×$²h üæhS ÷ 0 ÿ 1 ‡ 2 1 2 0 ÑsLži Ÿs îh ¯s ñh ¿s �s ëh ãsD°i �3 Æ! 3 79 =? ”Ài $Ãi > >�²
|
|||
|
|
/ Èi /
|
|||
|
|
3ËÑ×$Íi üñkl ÷ 5 ÿ 6 ‡ 7 5 6 7 ÑsLÂl Ÿs ùk ¯s ük ÅbË T¯l ¿s$ �s ök ãsDÔl �8 Æb 8 FH LN üäl4 çl ? @ A ?� @¦b¦b • ¨b°
|