85 lines
27 KiB
Plaintext
85 lines
27 KiB
Plaintext
|
!<arch>
|
|||
|
|
/ 0 0 0 0 8 `
|
|||
|
|
// 70 `
|
|||
|
|
scopeguard-ccb5054c1d5044be.scopeguard.c0a28c330e6ea90e-cgu.0.rcgu.o/
|
|||
|
|
lib.rmeta/ 0 0 0 644 26328 `
|
|||
|
|
ELF · Xe @ @ GNU À rust
|
|||
|
|
c #rustc 1.96.0 (ac68faa20 2026-05-25)ÁíàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ‰ 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Á ¥ — ¤ » dropfnÁ strategyÁ ¥ — ¤
|
|||
|
|
with_strategyÁ
|
|||
|
|
into_innerÁ £ ¥ — ¥ — ¤ $¥ $— $¤ $å $´ *¥ *— *¤ *¶ /¥ /— /¤ /ã 4¥ 4— 4¤ 4× AlwaysÁ :× )
|
|||
|
|
.
|
|||
|
|
3
|
|||
|
|
8
|
|||
|
|
8
|
|||
|
|
8
|
|||
|
|
;
|
|||
|
|
;
|
|||
|
|
;
|
|||
|
|
¿c 9 ýÙ´:b‹� à � æ » “ -´ë�³N7ž ¥—¤ é!… ö!… Œ"… ¿c… : 94
|
|||
|
|
9 $ * / ¿c#
|
|||
|
|
� é!ö!Œ" (›5 ; Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ŸÈŸÈ È ErrorÁ O˜éBL — à ¡ c c ˆ ¢cµ
|
|||
|
|
` £c bufÁ ` àB¤GS
|
|||
|
|
ç ð ±ý $Å8
|
|||
|
|
Ï8 ü£8, $¶8 ¤¡M
|
|||
|
|
( Œ¡M
|
|||
|
|
¼Ã ³M L 4ÝM
|
|||
|
|
ÌËM ŒËM
|
|||
|
|
¼É < $ ü�M‘ ÃÉÏ • • – PhantomDataÁ Fu\»Ÿ ÏÏ ˜N üºLÞ —N 3 … œãL à ÏL É 4ÕL ÃÛÃÛ ManuallyDropÁ ÅÛ»¬ „ µÜÀ,�%*à ž ÃÛÃÛ Ž ÅÛ»¬ „ µÜÀ,�%*É f É � Ò Á¡ “¥ ÿ Ù ¤
|
|||
|
|
¥É Ä“U Œ“U
|
|||
|
|
¼… ,¥U % ,âU \âU
|
|||
|
|
ë!ÃÛÃÛ Ž ÅÛ»¬ „ µÜÀ,�%*… Y Q U ‚ dáU
|
|||
|
|
ë!‚ € làU ÄÖU LÖU
|
|||
|
|
ÝÃ * " ,ÇW dÇW
|
|||
|
|
÷!™ ) ! ŒÂW
|
|||
|
|
Ç ü¯W% ”¯W
|
|||
|
|
ÁÉ
|
|||
|
|
2 % ,âW ÷W ðW üâS• üƒUô üÊU§
|
|||
|
|
à „T … ,ôS ™ L‡U à ,ÎU à , à [ ‚ Î … Ù ™ ô ©
|
|||
|
|
Þ Ç þ … - ™ I £{ £ »� Ô Ýx “E ûã ±µ æ„ ¥Oà ü¼Y$ ̼Y
|
|||
|
|
ÃÉà ÖY 4ÙY 2 âY üÞX„ æ » “ -´ë�³N7žÃÉà Ä…Y à ñX É 4÷X Á “ ˆ ˆØ T®g ‚ \g û ' ¾g ) üŒg2 Ä Ÿg Ú ,•g Ï d 3 ûk TÒh ‚ \Ñh
|
|||
|
|
÷!‚ . âh . ü hB à 4»h � Lh ‚ q 9 ˆw üæj> Tüj ‚ \ûj û ' dúj ¼ðj Lðj ± $ \•k Ç d”k
|
|||
|
|
ë!Ç - ! l“k
|
|||
|
|
ĉk L‰k
|
|||
|
|
ÝÉ
|
|||
|
|
* # üïj3 ,Õj
|
|||
|
|
à 4Üj
|
|||
|
|
É |±k l±k
|
|||
|
|
Ï
|
|||
|
|
$
|
|||
|
|
4Ïk
|
|||
|
|
,Ök
|
|||
|
|
lÏk T
|
|||
|
|
™"ÉÃ j 1 : ìk
|
|||
|
|
$ 2 : ík P ¡k üÀi ~
|
|||
|
|
Ž �
|
|||
|
|
|
|||
|
|
½
|
|||
|
|
3 j üÐj� ©
|
|||
|
|
Òi � LÈi à û É à ÃÉ Ã » º Ó Ä ù Ï É q É ‹ É » Ç Û ©
|
|||
|
|
® É ô è ¾ à å � ” ¤ »£ “Œ N û” ±l ©= à ã ’ ß (ÃŽÉôÃúÉ Ã °²m
|
|||
|
|
ü£m& d¥m
|
|||
|
|
÷c £m : ü¥m$ 0 <Ým
|
|||
|
|
¨" Tèm
|
|||
|
|
‚ \çm û
|
|||
|
|
' dæm ¿c ü£mP ,×m
|
|||
|
|
Ù` ¾ † D ä×m ü£mf 4�n
|
|||
|
|
à` R D�n �n 8 üäl« Û \�m Ú ,ël è
|
|||
|
|
òl Í`Í` DebugStructÁ Ð`×µ` Ñ`� µ` Ò`
|
|||
|
|
has_fieldsÁµ` ã¹q·Ù›ß¨ ú é$ £ ë$ « ¨" Ì ¨" ~ Â# ? Ä e Ï ‚ ² ±¶ á ¾"ý û�ÄÂ#‡ à#o –$? 9í À Í0 × Ü0 ` ò \ò0 • ò – Žd�1 ÃÛ r,ª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(|_| ())Á ,é Ã- ï ú |ó ç0 äƒ 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Ú ºF üá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¢ ºF ü© > ; // 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ú ž6 „ ú „ˆ
|
|||
|
|
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 =
|
|||
|
|
Ú† ×ĸ0 çD×0 ùÄå0 ´ƒ1 2DŸ1 EE``DÀ1 s”‰2 üË1= : Controls in which cases the associated code should be runÁ D“2 Îì ü‰2« Ïe Ïe Äš3 ü¢2= : Return `true` if the guard’s associated code should runÁ üä21 . (in the context where this method is called).ÁT�3
|