156 lines
18 KiB
Plaintext
156 lines
18 KiB
Plaintext
|
rust
|
|||
|
|
cF #rustc 1.93.0 (254b59607 2026-01-19)Á³VOÐêùÿ²?ÑL¼�§Ì± -a7a40eb546f9e2b0Á “õ…·fÊvŠ ¦%g- -c48c539199cbc88bÁ á\ƒ¦è3$|]åŒ[IÚ tæ -14b12edc9f8cd90bÁ ë&Gf·Ã ¬ëñq:¤»b -bb76018b1173caf6Áà 9m Ù„«ÐÒþá•c‘B; -030c5b0bba47cc8fÁ rustc_std_workspace_coreÁÛ¹þÓ7>H%¸ÚÉ’› -4b81d37a5530864dÁ üÃùs<Uß7VyóHr#QÏ -c66cc7807550ce25Á miniz_oxideÁõFÖˆÚ™ª‹"ÞXzLVª -62cbc7af83058505Á adler2Á—wÉD‘嵯�|6¨%Œ
|
|||
|
|
+ -2f171dd2394b4b62Á hashbrownÁ,ïcV¼¨ø¢:Ê\'È߈ -9571ba9e0f6c7a90Á rustc_std_workspace_allocÁ%¥Èxµù·¼5Ä3Bœ -aac566ad65903fa4Á
|
|||
|
|
std_detectÁMmáýZ^9õ Îà§e˜÷e -2edb296e590136d8Á rustc_demangleÁ@¼§VÉNb˜æ¨fHÌ+V3 -53b132e4a2fa6e26Á cfg_ifÁfÝv�.Å"ÒÜuPp¹ˆ¶ -f76b385d7d4d7f3eÁ addr2lineÁÕú-WiúQVÓ¬
|
|||
|
|
µT§�5 -fe25100bd73e48e4Á gimliÁ¹xLáÇí÷‘o ±Ñ8£Å -265ba9e6e4f70b3fÁ objectÁÔ³ÝzÓÿ¶ò°öM›¼òü` -9ae0d1f8ea52a318Á memchrÁRÎ÷׎™te~QÓ¿ØC\Ò -0bff3c8e8f4e489eÁ –©H�tGNÏ ·ˆ!á -d69228d077d46f36Á doc_commentÁ\Û «<· ³ lazyÁ ³ “ LazyÁ
|
|||
|
|
™ ì í ™ INITÁ getÁ FÁ ™ __lazy_static_createÁ __lazy_static_internalÁ lazy_staticÁ
|
|||
|
|
LazyStaticÁ
|
|||
|
|
initializeÁ Ü ™
|
|||
|
|
|
|||
|
|
„ ¢ ì í ÒKË2Ãä@ ™ „ üÜ ¬æ
|
|||
|
|
Ͼ
|
|||
|
|
‘» + 8
|
|||
|
|
? LÜ
|
|||
|
|
ê,�Ò�Ò MaybeUninitÁ �Ò uninitÁü �Ò˜ü gÇ@ÇeÉR» � ® û ü×1
|
|||
|
|
» Lþ Œ5 ÿ4ÿ4 OnceÁ €5 innerÁù4 ‚ýu´b$bÔ ‡ üÀI … $Ð É,É, q Ë,˜¸+ »\¡Ø Ê–¡ n ¡ m `¯ Œ5
|
|||
|
|
_Á ÄÔ
|
|||
|
|
» ) … 4 Ž ;
|
|||
|
|
B I ³ ý¤Ú __DerefÁ<Ü ì œ ´¦ ¹ \Ù% üØä. üØŽ ‰
|
|||
|
|
A macro for declaring lazily evaluated statics.
|
|||
|
|
|
|||
|
|
Using this macro, it is possible to have `static`s that require code to be
|
|||
|
|
executed at runtime in order to be initialized.
|
|||
|
|
This includes anything requiring heap allocations, like vectors or hash maps,
|
|||
|
|
as well as anything that requires function calls to be computed.
|
|||
|
|
|
|||
|
|
# Syntax
|
|||
|
|
|
|||
|
|
```ignore
|
|||
|
|
lazy_static! {
|
|||
|
|
[pub] static ref NAME_1: TYPE_1 = EXPR_1;
|
|||
|
|
[pub] static ref NAME_2: TYPE_2 = EXPR_2;
|
|||
|
|
...
|
|||
|
|
[pub] static ref NAME_N: TYPE_N = EXPR_N;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Attributes (including doc comments) are supported as well:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
use lazy_static::lazy_static;
|
|||
|
|
|
|||
|
|
# fn main() {
|
|||
|
|
lazy_static! {
|
|||
|
|
/// This is an example for using doc comment attributes
|
|||
|
|
static ref EXAMPLE: u8 = 42;
|
|||
|
|
}
|
|||
|
|
# }
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
# Semantics
|
|||
|
|
|
|||
|
|
For a given `static ref NAME: TYPE = EXPR;`, the macro generates a unique type that
|
|||
|
|
implements `Deref<TYPE>` and stores it in a static with name `NAME`. (Attributes end up
|
|||
|
|
attaching to this type.)
|
|||
|
|
|
|||
|
|
On first deref, `EXPR` gets evaluated and stored internally, such that all further derefs
|
|||
|
|
can return a reference to the same object. Note that this can lead to deadlocks
|
|||
|
|
if you have multiple lazy statics that depend on each other in their initialization.
|
|||
|
|
|
|||
|
|
Apart from the lazy initialization, the resulting "static ref" variables
|
|||
|
|
have generally the same properties as regular "static" variables:
|
|||
|
|
|
|||
|
|
- Any type in them needs to fulfill the `Sync` trait.
|
|||
|
|
- If the type has a destructor, then it will not run when the process exits.
|
|||
|
|
|
|||
|
|
# Example
|
|||
|
|
|
|||
|
|
Using the macro:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
use lazy_static::lazy_static;
|
|||
|
|
use std::collections::HashMap;
|
|||
|
|
|
|||
|
|
lazy_static! {
|
|||
|
|
static ref HASHMAP: HashMap<u32, &'static str> = {
|
|||
|
|
let mut m = HashMap::new();
|
|||
|
|
m.insert(0, "foo");
|
|||
|
|
m.insert(1, "bar");
|
|||
|
|
m.insert(2, "baz");
|
|||
|
|
m
|
|||
|
|
};
|
|||
|
|
static ref COUNT: usize = HASHMAP.len();
|
|||
|
|
static ref NUMBER: u32 = times_two(21);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
fn times_two(n: u32) -> u32 { n * 2 }
|
|||
|
|
|
|||
|
|
fn main() {
|
|||
|
|
println!("The map has {} entries.", *COUNT);
|
|||
|
|
println!("The entry for `0` is \"{}\".", HASHMAP.get(&0).unwrap());
|
|||
|
|
println!("A expensive calculation on a static results in: {}.", *NUMBER);
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
# Implementation details
|
|||
|
|
|
|||
|
|
The `Deref` implementation uses a hidden static variable that is guarded by an atomic check on each access.
|
|||
|
|
|
|||
|
|
# Cargo features
|
|||
|
|
|
|||
|
|
This crate provides one cargo feature:
|
|||
|
|
|
|||
|
|
- `spin_no_std`: This allows using this crate in a no-std environment, by depending on the standalone `spin` crate.
|
|||
|
|
|
|||
|
|
Á¡ ë î ¢ 8¹ lï ý 7 !https://docs.rs/lazy_static/1.5.0Á üÿ# üè< ³G ýV ãl ì œ } ¹ Œ d¢ ¡ • ˜ Ÿ 8° 4™ t“ $ª ³$å “ ø q$“ É, \ �Ò · $î ÿ4 ONCE_INITÁL¢ Œ5
|
|||
|
|
Š%ª® ¨â Œ-°® ©â —%·® „ UnpinÁ-½® åâ DropÁ%š® � ™ ® “ š-¤® – ›5«® ™ AsyncFnÁ=’® Þ
|
|||
|
|
AsyncFnMutÁU›® á AsyncFnOnceÁ]§® æ ²%£® µ ÝE‰® ¢ Þe“® ¤ é=¡® ˜ ê]ª® š M-²® ô N-¹® ñ ž%À® ú °%Æ® ÷ Œ�£ ® òJ ExactSizeIteratorÁ�¸ ® ©K ExtendÁ5¢
|
|||
|
|
® ·J ²eª
|
|||
|
|
® ®J ÂE¸
|
|||
|
|
® ÞK Ó%£ ® ø° Ð%© ® ú° Ð û° �%¯ ® ü° � ý° ý%– ® ê³ “ œ ® ð³ “ ñ³ Ò¡ ® í³ Ò î³ ‘5¸
|
|||
|
|
® ˜ ¢ À
|
|||
|
|
® ” ä5Å
|
|||
|
|
® Ž émÍ
|
|||
|
|
® … ï5Ü
|
|||
|
|
® Œ Ò ä
|
|||
|
|
® ‰ À%é
|
|||
|
|
® � â]ï
|
|||
|
|
® † åu€® ˆ ð=�® • ñm™® ’ ó]¨® ‘ È %µ® � å U»® ™ é
|
|||
|
|
]Ç® “ å UÔ® Š µMä® � õeï® š u-ý® Þ u â %„® þ ÿ �-Š® ã` …=‘® Ä … Æ ‘š® £ ‘ ¥ ¦%ž® Áb Ô ¤® Ã Ô È ÛM©® ž Û ¢ ÜU´® É Ü Ø ðe‡® ‹ â�ó® £ ä-ˆ® ž ‰5�® › š…—® à%©® � ãM¯® Ÿ ‹e‘® œ £uÛ® ¤ «E¤® ¥ —eè® �Œ ‚-®® § ümÿ® ¦ œ=Ì ® ± BoxÁ « ® • ’5ˆ ® ÉH �E� ® ×5 ï ® ßA ŒØæ„ëÛ¬‚ÑÜ�Å´¾¬Ý¼Ô‘§ì $ß ™
|
|||
|
|
|
|||
|
|
©â» ä „ » $ç… ÒKË2Ãä@ Ž
|
|||
|
|
… ìb Ž
|
|||
|
|
…
|
|||
|
|
» rt ¤í Ž$ƒ
|
|||
|
|
¬‹ ™ Ï5 � ß5$“… ¤À$Ê … ü¥L ¬ … æ » æ ©âþ7 ° ™ þ7 lã þ7¿8› » ï
|
|||
|
|
» þ7$¼þ ÂCE ‘ <closure_kind>Á <closure_signature>Á <upvars>Á » þ7 ¿8¿8 … þ7ü„ % ™ Ï5 � ß5$“ … üÍ !¡ À Ã Ê 8° 4Ä t¾ &|® V ï ß
|
|||
|
|
õ ˆ
|
|||
|
|
, ö 8 NAMEÁ $÷ & û 8Û ,ü $ �
|
|||
|
|
, ƒ
|
|||
|
|
8™ „
|
|||
|
|
& …
|
|||
|
|
8” †
|
|||
|
|
*Š
|
|||
|
|
�
|
|||
|
|
Ü
|
|||
|
|
8 4—
|
|||
|
|
, ž
|
|||
|
|
8¢: $Ÿ
|
|||
|
|
& £
|
|||
|
|
, ¥
|
|||
|
|
8 ,¦
|
|||
|
|
'«
|
|||
|
|
8õ $
|
|||
|
|
'±
|
|||
|
|
8¢ $³
|
|||
|
|
·
|
|||
|
|
, ¸
|
|||
|
|
8™ ¹
|
|||
|
|
º
|
|||
|
|
¼
|
|||
|
|
, ¾
|
|||
|
|
8 ,¿
|
|||
|
|
'Ä
|
|||
|
|
8õ $Æ
|
|||
|
|
'Ê
|
|||
|
|
8¢ $Ì
|