1247 lines
195 KiB
Plaintext
1247 lines
195 KiB
Plaintext
|
rust
|
|||
|
|
€ #rustc 1.93.0 (254b59607 2026-01-19)Á“õ…·fÊvŠ ¦%g- -c48c539199cbc88bÁ ³VOÐêùÿ²?ÑL¼�§Ì± -a7a40eb546f9e2b0Á á\ƒ¦è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Á5 AsDisplayÁL© ¶<ƒ serdeÁ<� Œƒ ¼Þ,�¶<ßÞ<éŒß¼ arbitraryÁLö<Ÿ‘\©¬Ÿ¼ bytemuckÁDü¶<Ù¹Tã¤Ù»Þ,©¶<�Þ<—Œ�» __impl_external_bitflags_serdeÁôö<¢Þ<¬Œ¢»‘Lû&¶<Û&‘\å&¬Û&»¹D¨'¶<�'¹T—'¤�'» "__impl_external_bitflags_arbitraryÁü·("¶<’(‘\œ(¬’(» !__impl_external_bitflags_bytemuckÁüü0!¶<Ø0¹Tâ0¤Ø0 example_generatedÁŒäå¶<¼åü
|
|||
|
|
œÆåì¼å testsÁ,‰æà$þå “ £ IterÁ BÁ innerÁ doneÁ ‰ • ‰ __private_const_newÁ ‰ ½ ¥ IterNamesÁ ‰  idxÁ sourceÁ remainingÁ ‰ • "‰ "Å "
|
|||
|
|
&‰ &½ &¥ IterDefinedNamesÁ *‰ *Â *–
|
|||
|
|
.‰ .• 1‰ 1½ 1¥ parserÁ 5 555555 to_writerÁ <‰ <
|
|||
|
|
impl WriteÁ 5÷ ?‰ ? ? 5 to_writer_truncateÁ C‰ C” 5 from_str_truncateÁ F‰ 5 to_writer_strictÁ H‰ H” 5 from_str_strictÁ K‰ K 5 WriteHexÁ N write_hexÁ O WÁ 5 ParseHexÁ Q parse_hexÁ 5 S invalid_hex_flagÁ T impl fmt::DisplayÁ S invalid_named_flagÁ V¨ S
|
|||
|
|
empty_flagÁ 5YÍ 5 traitsÁ \ \\\\\\\\\ \
|
|||
|
|
\ \ \ j‰ j• jÿ
|
|||
|
|
j˜ j is_namedÁ j
|
|||
|
|
is_unnamedÁ \ FlagsÁ q FLAGSÁ q BitsÁ q emptyÁ qà q contains_unknown_bitsÁ q bitsÁ q from_bitsÁ q from_bits_truncateÁ q from_bits_retainÁ q from_nameÁ q£ q
|
|||
|
|
iter_namesÁ q iter_defined_namesÁ q is_emptyÁ q is_allÁ q
|
|||
|
|
intersectsÁ q containsÁ q truncateÁ q insertÁ q removeÁ q toggleÁ q setÁ q clearÁ q intersectionÁ qC q
|
|||
|
|
differenceÁ q symmetric_differenceÁ q
|
|||
|
|
complementÁ \™ Ž EMPTYÁ Ž ALLÁ \ PrimitiveÁ \ impl_bitsÁ \ PublicFlagsÁ “Ü “ InternalÁ \ BitFlagsÁ –þ –ø \™‰ ™þ ™ø \�‰ \ ImplementedByBitFlagsMacroÁ \ __privateÁ Ž ¤ ¤¤¤ bitflagsÁ __impl_bitflagsÁ bitflags_matchÁ __bitflags_matchÁ __bitflags_expr_safe_attrsÁ __bitflags_flagÁ –
|
|||
|
|
± __declare_public_bitflagsÁ ± __impl_public_bitflags_forwardÁ ± __impl_public_bitflagsÁ ± __impl_public_bitflags_iterÁ ± __impl_public_bitflags_opsÁ ± __impl_public_bitflags_constsÁ † ¸ __declare_internal_bitflagsÁ ¸ __impl_internal_bitflagsÁ ü »Ž » __impl_external_bitflagsÁ »ÿ »ú »¼
|
|||
|
|
5
|
|||
|
|
ParseErrorÁ Á
|
|||
|
|
Áì 5ÄÍ 5 ParseErrorKindÁ Æ EmptyFlagÁ Ç
|
|||
|
|
Æ InvalidNamedFlagÁ É gotÁ Æ InvalidHexFlagÁ Ë 5ÍÍ \ FlagÁ ω Ïÿ
|
|||
|
|
Ϙ \Ó‰ ÓÍ \ÖÅ ÖÒ \ÙÅ ÙÒ \Üý Ý \ßý à \âÖ ãæ \ åÖ ææ \
|
|||
|
|
\ \ êÅ êÒ \
|
|||
|
|
íÅ íÒ \ðý ñ \óý ô \öÖ ÷æ \ùÖ úæ \\\þÅ þÒ \�Å �Ò \„ý … \‡ý ˆ \ŠÖ ‹æ \�Ö Žæ \\\ ’Å ’Ò \ •Å •Ò \ ˜ý ™ \ ›ý œ \ žÖ Ÿæ \!¡Ö ¢æ \"\#\$¦Å ¦Ò \%©Å ©Ò \&¬ý \'¯ý ° \(²Ö ³æ \)µÖ ¶æ \*\+\,ºÅ ºÒ \-½Å ½Ò \.Àý Á \/Ãý Ä \0ÆÖ Çæ \1ÉÖ Êæ \2\3
|
|||
|
|
|
|||
|
|
!
|
|||
|
|
%
|
|||
|
|
)
|
|||
|
|
4
|
|||
|
|
<
|
|||
|
|
?
|
|||
|
|
C
|
|||
|
|
F
|
|||
|
|
H
|
|||
|
|
K
|
|||
|
|
O
|
|||
|
|
R
|
|||
|
|
Z
|
|||
|
|
Z
|
|||
|
|
Z
|
|||
|
|
m
|
|||
|
|
n
|
|||
|
|
o
|
|||
|
|
p
|
|||
|
|
v
|
|||
|
|
w
|
|||
|
|
{
|
|||
|
|
|
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
‚
|
|||
|
|
ƒ
|
|||
|
|
„
|
|||
|
|
…
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
ˆ
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Î
|
|||
|
|
Î
|
|||
|
|
Î
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Ý
|
|||
|
|
à
|
|||
|
|
ã
|
|||
|
|
æ
|
|||
|
|
ñ
|
|||
|
|
ô
|
|||
|
|
÷
|
|||
|
|
ú
|
|||
|
|
…
|
|||
|
|
ˆ
|
|||
|
|
‹
|
|||
|
|
Ž
|
|||
|
|
™
|
|||
|
|
œ
|
|||
|
|
Ÿ
|
|||
|
|
¢
|
|||
|
|
|
|||
|
|
°
|
|||
|
|
³
|
|||
|
|
¶
|
|||
|
|
Á
|
|||
|
|
Ä
|
|||
|
|
Ç
|
|||
|
|
Ê
|
|||
|
|
NQqŽ‘“–ŸÞK þ
|
|||
|
|
‘ � á☚8(„ ‰ ÞK ø  –
|
|||
|
|
|
|||
|
|
|
|||
|
|
ÓûÜÌò‰ ó' ÞK * * � , -–
|
|||
|
|
²ãf³°g’Bó' à` Á Á ¿ Ãì 5 ¸F´ VJÜ à` Æ Ç Èÿ É • Ê 5 Ë ¸ Ì 5 ÄT}j]Ý7Ú å`Ž) ÏŽ) à` Ï Ï á Ñÿ
|
|||
|
|
\ Ò˜ \ ‚D9-DV@šó' Ž Ž Qô* Qþ* Nô* Nþ* ‘þ* ‘ô* Ž Ž QÀ+ QÊ+ NÀ+ NÊ+ ‘Ê+ ‘À+ Ž Ž QŒ, Q–, NŒ, N–, ‘–, ‘Œ, Ž Ž QØ, Qâ, NØ, Nâ, ‘â, ‘Ø, Ž Ž Q¤- Q®- N¤- N®- ‘®- ‘¤- Ž Ž Qð- Qú- Nð- Nú- ‘ú- ‘ð- –ó' Ÿó' & 1 *Ä ÁÍ ÆÓ ÏY Á[ ÁÖÙêíþ�’•¦©º ½ Üßð󄇘›¬¯À à âåöùŠ�ž¡²µÆ É èéüý�‘¤¥¸¹Ì Í ™ � ÞK¦à`å`Ï Ž Q < N < ‘ < –< Ÿ ¬Ç tÇ
|
|||
|
|
!ó' ,Ö $ üS
|
|||
|
|
ó' ,ð † üþˆ À' $ž ó' ,� €( ‚ Â 8 µ1Ÿ üá8 ôá
|
|||
|
|
$ó' ,€ 4‡ L� 3 üÇv
|
|||
|
|
ó' , Ã üàã À' $¸
|
|||
|
|
³* ,� ó' 4œ ó' L§ €( ¤ Â%
|
|||
|
|
)
|
|||
|
|
- e â2Û å Ð Ö Ú à ä ê
|
|||
|
|
& $ â2 O ˜ 1
|
|||
|
|
ó' / ¼ 6 0 > À' ; Ô3 6 ó' 5 ó' 4 €( × Ô3 Ä ó' Å ó' Æ Âq
|
|||
|
|
v
|
|||
|
|
{ ´ T¾ €( Œ¾ $É
|
|||
|
|
àK€( 0 4É ( ¼¸ H L’ $ç � ó'ó' Tñ
|
|||
|
|
ø°ó' ú $Œ
|
|||
|
|
ø° ó' „± $½ T·
|
|||
|
|
€( ´·
|
|||
|
|
LÂ
|
|||
|
|
|
|||
|
|
%ó' . \Â
|
|||
|
|
ü·
|
|||
|
|
! DÎ
|
|||
|
|
|
|||
|
|
ó' C TÎ
|
|||
|
|
*
|
|||
|
|
$Ó
|
|||
|
|
ø° ó' ü³
|
|||
|
|
¶ ¤ˆ €(ó' ܈ $�
|
|||
|
|
wó' 2 4� üô
|
|||
|
|
0 ϙ
|
|||
|
|
|
|||
|
|
zó' C
|
|||
|
|
" üï
|
|||
|
|
6
|
|||
|
|
ø°ó'
|
|||
|
|
� ¡
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
ü…œ ìÞ ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>ó' ”› À' L� ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>š8 ø €( ú- |Þ ó' ¥ Í õ ™2 & €( F ó' r ó' s © ™2 Ê ú- < º flagÁ ; ¥7‰ ©9‹ Ó9h Ç:ù ñ:Ö d§ $ Ç: ,§ 4 ü“! œ“ ñ: ; dÞ $ä Ç: ,Þ 4ä üÊ! œÊ ñ: < ü¿·
|
|||
|
|
ó' DÞ ró' Ô3 ù ð- ü õ ü�ì ! €( $° ™2 ,¢ ó' ù Ù= & ó' ¾ Ù= ì Â) X¤ ró' Ô3 Ç:_ ñ:? Ç:" ñ:ó'˜ üÀg
|
|||
|
|
ó' ð ð- $ üÙÔ €( $± Ô3 ,ú ó' 4• ó' L Â
|
|||
|
|
"
|
|||
|
|
& Z
|
|||
|
|
,Ø Lÿ 4– å
|
|||
|
|
ó' â ð- ¦ ô $ ò €( î Ô3 ì ó' ê ó' è Ô3 ± ó' ¥ ó' ™ Â
|
|||
|
|
|
|||
|
|
# X |ó ó' ˆ % üË= ™2 æ Æ= ,Ü , ü’® T© Ô3 D¸ ð- Ä© ´
|
|||
|
|
ÿp³*ð- C 6 l´ 0 Tœ $¡ � ³* t† ó' ̆D• Ó9 ) T• $ $¹
|
|||
|
|
ø° š8 lÚ ð- æ ð- ) ð-, ð- T ð- ð- \›$
|
|||
|
|
mó' $›
|
|||
|
|
4 ´›D§
|
|||
|
|
±y
|
|||
|
|
B T§ '
|
|||
|
|
dô,ù
|
|||
|
|
nó' $ô <ù œô$� Ç: ? 4� \™ ó' Ì® œ® ñ: $Â
|
|||
|
|
ü™ /D¥
|
|||
|
|
‚ó' T D
|
|||
|
|
ü¥ # 1
|
|||
|
|
tÜ ó' Ìö œö ñ: $Š üÜ 4Të
|
|||
|
|
�ó' T D üë % 1 t¯ ó' ÌÅ œÅ ñ: $Ù ü¯ 04¾
|
|||
|
|
…ó' U D ü¾ ! \ÿ $„ ÊH $ÿ 4„ ÌŒ œŒ ñ: $ üþ (
|
|||
|
|
üù .
|
|||
|
|
ø°š8 ò $Ê
|
|||
|
|
ø° š8 Ô üßõ ) üÂþ üé× È< ”õ ”= Lç ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>æF t ð- � ú- H æF > ™2 3 ð- Ø J œ8 } Ù= $í ™2 , ™2 î ó' á L ™2 � ó' € ë ó' 0 ó' " š8 � œ8 Ý ó' ¿ Ô3 ‡=ù Ó– m ’Fe Ó9î ÊH9 õH ¬Iã Ç:¾ ñ:� ³Jo ñ:! «K ñ:´ ¤L– ÊHk ñ:K ü¾#M
|
|||
|
|
* ó' Dä# ró' Ô3 ÿ# ð- ‘$ 0 ü˜#y Ñ( $¯# P ró' Ô3 ü¢%‚ T¹%
|
|||
|
|
Ô3 DÈ% ð- Ĺ% Ä% ’F
|
|||
|
|
: - lÄ% ' T¬%
|
|||
|
|
$±% � æF là% ð- ì% ð- ) ð-, ð- T ð- ð- |¥&Dª&
|
|||
|
|
oó' $¥& Tª& + \Ô&$Ù& ÊH $Ô& 4Ù& dõ&,ú& ¬I $õ& <ú& œõ&$‚' Ç: : 4‚' üá&(œá& ñ: 9
|
|||
|
|
|
|||
|
|
üÓ&7
|
|||
|
|
|
|||
|
|
üÎ&=
|
|||
|
|
ø°š8 ¸' $®'
|
|||
|
|
ø° š8 " + üï$É 4 üÒ%Ò È< ”…% Ñ( L÷$ ±N 0 ð- L ú-
|
|||
|
|
æF ¤O ô ‘ š8 Í œ8 e ó' ý Ù= ( ™2 V Ô3 ^ g ‡=V ¯ ’F ÈTí ÊH¸ ¬I˜ Ç:x ñ:Z 4LÐ -
|
|||
|
|
- $Ü
|
|||
|
|
”õ Tû
|
|||
|
|
}ó' ,õ .dû Lž
|
|||
|
|
H,ž
|
|||
|
|
|
|||
|
|
±J”= * )" & ø,�
|
|||
|
|
Ÿ ? NS
|
|||
|
|
àK”= d )m q
|
|||
|
|
}
|
|||
|
|
… $’
|
|||
|
|
� š8 œ8 ,¶
|
|||
|
|
,« ) 4Ê
|
|||
|
|
,Û
|
|||
|
|
|
|||
|
|
œ8 ¼Ê
|
|||
|
|
LÑ
|
|||
|
|
|
|||
|
|
Œ`” B 8 („Ñ
|
|||
|
|
À-Ê
|
|||
|
|
|
|||
|
|
¡"ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘ýOѼѼҼ” štÀ. Â
|
|||
|
|
|
|||
|
|
(˜ œ
|
|||
|
|
¨ º.á
|
|||
|
|
|
|||
|
|
¤"Ž\ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘äß Œi•Î/Wfì ß\g Ë]� /(I l÷
|
|||
|
|
,ÿ
|
|||
|
|
4Ž ´Ž L• Ö[ % $Ÿ
|
|||
|
|
(|• ¸/Ž ˆ\ ? ( , H ) O
|
|||
|
|
0¤ Â]0 Ë] 0(q $‘ „‘ L– ©9 $ )\– ¼‘ $¢ Ç: 9 )4¢ L±
|
|||
|
|
t¾
|
|||
|
|
|
|||
|
|
�Ù= Ù=
|
|||
|
|
ܱ
|
|||
|
|
|
|||
|
|
¡Ù=Ù= Q H ) ) /
|
|||
|
|
" ,Û
|
|||
|
|
|
|||
|
|
4ï
|
|||
|
|
,€
|
|||
|
|
|
|||
|
|
!
|
|||
|
|
œ8 ¼ï
|
|||
|
|
Lö Ö[ 9! / )„ö À1ï
|
|||
|
|
ˆ\ = )
|
|||
|
|
" ,
|
|||
|
|
" >2†
|
|||
|
|
Â]Ë
|
|||
|
|
Ë] 1)` 4œ
|
|||
|
|
|
|||
|
|
% $
|
|||
|
|
|
|||
|
|
&
|
|||
|
|
œ8 ´œ
|
|||
|
|
|
|||
|
|
L£
|
|||
|
|
Ö[% 9& /$ )|£
|
|||
|
|
¸3œ
|
|||
|
|
|
|||
|
|
ˆ\$ =# )
|
|||
|
|
' # ,
|
|||
|
|
' L½
|
|||
|
|
|
|||
|
|
* 4Ñ
|
|||
|
|
|
|||
|
|
-
|
|||
|
|
|
|||
|
|
+ ܽ
|
|||
|
|
|
|||
|
|
LÇ
|
|||
|
|
|
|||
|
|
OÙ=Ü[* K+ B) )ŒÇ
|
|||
|
|
�4²
|
|||
|
|
Â]Ý Ë] 2)¿ à5½
|
|||
|
|
|
|||
|
|
ˆ\) m( )
|
|||
|
|
, ( ,
|
|||
|
|
, "! >6Ø
|
|||
|
|
Â]C Ë] 3)` œæ
|
|||
|
|
|
|||
|
|
|
|||
|
|
ê³ ýOß\ s ýO ú
|
|||
|
|
#. - '+ Ú %) 3 &. C - ', û
|
|||
|
|
) n . ü–å Š ' ™ ' ¨ * ¸ - *- $ €
|
|||
|
|
$ Þ % 5 % z % < � üÌ ¯ üæ • m ü¨
|
|||
|
|
„ ¹ À ÄÊ
|
|||
|
|
Ÿ ¦ ¼Ž ü� ú *
|
|||
|
|
1 Äï
|
|||
|
|
4
|
|||
|
|
; ¼œ
|
|||
|
|
|
|||
|
|
ê
|
|||
|
|
ñ ä½
|
|||
|
|
|
|||
|
|
.Ž\ ´× ™2 ,± Ü[ T¼ Þ €( Dê ”= x ”= ‘ ”= ˆÈ< � ”= › ú- p œ8 â—å— æ—} ç—ì è— é—iê—ì ºÀe?=c&Ë]ýO Ð Ž\ Ü[ ; œ8 4 ú- 4 ùj Z Ž\ Ž Øk § ú- Ù= L… ™2 þ Æ= � Ù= Ð ³l Ê Ù= Ò t ùj Ž\ B Øk o œ8 h ú- í ùj … Ž\ · Øk ä œ8 Ý ú- ùj è Ž\ J ³l � Ü[ { ú- Å …  writerÁÍ firstÁ¶
|
|||
|
|
£ Ü £ W
|
|||
|
|
ÿ
|
|||
|
|
Í Ú
|
|||
|
|
w k Ë] –Â } ýO Ú
|
|||
|
|
e � Ë] –Ê ¡ ýO
|
|||
|
|
c
|
|||
|
|
Ú
|
|||
|
|
ú ¿ Ë] –Ô Ñ ýO Ú
|
|||
|
|
ã Ë] –Ü õ ýO Ú
|
|||
|
|
Ê Ë] –ä ýO &| �Ù= Ù= •Y� ÏYL šZR È<ˆ
|
|||
|
|
Ö[X
|
|||
|
|
ˆ\+
|
|||
|
|
Â]1
|
|||
|
|
Ö[ ˆ\œÈ<¬
|
|||
|
|
Â]¨ ©9) Ç:
|
|||
|
|
«a· Ö[> ˆ\ Â] Ö[� ˆ\y ôd Â]… ˆ\Æ Â]Ì€(HÈ< €(TÈ< €(`Ü[fÜ[lÜ[r *„› (
|
|||
|
|
T® (
|
|||
|
|
D®
|
|||
|
|
tó' 0 d� $‡
|
|||
|
|
ƒz ,� "4‡ ¼� DŽ õH > "TŽ % d (
|
|||
|
|
„ª
|
|||
|
|
ê³ ó'Ž) á % „Ó ,Ù
|
|||
|
|
ãy ,Ó ß | "TÙ €7Ó
|
|||
|
|
±JºÄºÄ »Ä SplitÁ ¾Äì›s Lù‚mœRd\ ‘ "] a ø7Çç z
|
|||
|
|
‰Ž
|
|||
|
|
àK‡t
|
|||
|
|
Ÿ "¨ ¬ ¸
|
|||
|
|
ò $Ë � œ8 \ù $þ r $ù
|
|||
|
|
|
|||
|
|
"4þ d· (
|
|||
|
|
' „´
|
|||
|
|
ê³ ó'Ž) ' Å (
|
|||
|
|
Æ ! |Ï DÔ õH
|
|||
|
|
$Ï "TÔ ' Äø ´ø
|
|||
|
|
X " ìô
|
|||
|
|
ê³ó'Ž) % ¼Ä dÉ
|
|||
|
|
�zœ8
|
|||
|
|
$Ä $Ö œ8 "”É 9 T·
|
|||
|
|
$¼ � œ8 Ô… ¤…
|
|||
|
|
RÙ= $š "% ü¨&
|
|||
|
|
Aó'–, Ž)Ž) œ8 ü…J <
|
|||
|
|
¸YÙ=Ž)Ž) Aó'–,˜y¥y — s "ü / ø8…K
|
|||
|
|
¡"ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘Ù=Ž) ´ "t x „
|
|||
|
|
ü…K } Ù= Ìß œß ñ: $ó &" 9Ï i ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘™^Ž) : p
|
|||
|
|
¤"ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘ó'Ž)à{ Õ '"® ”« d«
|
|||
|
|
{ó'
|
|||
|
|
$¸ "$ üÉ'
|
|||
|
|
|
|||
|
|
Bó'–, ýOŽ) ¥y ü«F T¾
|
|||
|
|
ªRó'Ž) Bó'–,ú}¥y Œ i "ü¾3 ø:«G
|
|||
|
|
¡"Ç| ` "# ' ! 3!
|
|||
|
|
ü«G # } ó' # ü°Ì ;ñ " i à{ ‹
|
|||
|
|
Á| " ) ("¤ d‡ % \› & ü‡ 4”
|
|||
|
|
„ó'% 9& /$ )"œ”
|
|||
|
|
(
|
|||
|
|
! 3 # ü´’ P ` ( $ ¾ % p
|
|||
|
|
% ´ ? Y ü—¯ ‰ üäÊ üîÀ üž� üܦ üê˜ X _ ¢ ©
|
|||
|
|
z � · ¾ )Ç| ¬Þ œ8 ,Î ó' ¬ ? œ8 q ó' ‡t Ÿ ‡t ä ‡t ¯ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>œ8 û ‡t ú- œ8 E œ8 $ò º Ž) ‹ ó' \¢ ¨ƒ V ú- œ8 â—å— æ—} ç—ì è— é—iê—ì ºÀe?=c&à{Ù= Ÿ �z ð �z ] Ñy < §y D ú- ÷ à{ ÿ Ù= Câ—å— æ—} ç—ì è— é—iê—ì ºÀe?=c&à{ó' Ö Ç| $ ï; ‰ ©~ i §y q ú- Œ à{ ” ó' Ë ýO P …P v ó' o ó' J inputÁ. parsed_flagsÁë
|
|||
|
|
£ Ë ‡= ‡=Å
|
|||
|
|
parsed_flagÁÄ ‡=Å Ó$î Ú
|
|||
|
|
G –�
|
|||
|
|
Ú
|
|||
|
|
e " – # ½ þqn r> õH Ås¥
|
|||
|
|
�tn
|
|||
|
|
‡ut
|
|||
|
|
r� õH ¥wã ìw¢ Ýx8 ÂyÙ Šz– ñ:ï Á|¢ ¿}ó �~œ â~\ Á|b ©€£ó'„ ó'Š $É §y ü¬" ä¬
|
|||
|
|
Tœ8 : $ Í Î Ò A à Ž) « Ñy õ Ž) © œ8 ¨ §y
|
|||
|
|
‡=Z §y & „Š´Ž)�Ž)”
|
|||
|
|
_ref__flagÁ $ë §y üÌ$ ôÌ
|
|||
|
|
Vœ8 : # ð B H Ž) Ë ©~ ] œ8 t §y l ‡=> §y … ù‹€ »Š ü‘ $ d¨ $® Ç: ,¨ 4® ü’ # ¬’
|
|||
|
|
yó' A # w 4·
|
|||
|
|
ü‡ 7 L‡
|
|||
|
|
<ó'Ü[ Á C + ¿ À ü‡¹ 8 H C 1 Ž\ ´Í ™2 ,« Ü[ 4¶ ™2 X ó' Ù= ? Ü[ í ¡ Â: æl> – Ç:w ×�W «Ž
|
|||
|
|
ó'ßó'äÜ[é ¤Ù lÙ
|
|||
|
|
?ó' ,ç # ¨<Ù â~ < + = ¬Ù
|
|||
|
|
} ó'
|
|||
|
|
! äÙ $ï Ç: C 4ï =í i à{ ® Á| ) Æ üà 3 ¬Ã ×� p üÀ 7
|
|||
|
|
ê³ ó'Ž) ø ù
|
|||
|
|
üÔ ¥ F » Á Ç| ¬‡ œ8 ,÷ ó' ¶ Ù= ™2 N ó' V Ø… ¢ Ç| Ó ú- à{ % ó' ’†U Ú
|
|||
|
|
F –¤
|
|||
|
|
¶ Ñ�# â~ Ç:” Á| ×�Gó'
|
|||
|
|
ó' $³!
|
|||
|
|
”Ì! TÒ! •Y ,Ì! dÒ! Lõ! H>õ! ÏY $ ø>ä!Ÿ 9 HM šZ X a e
|
|||
|
|
q
|
|||
|
|
L# $é! � š8 œ8 ,�" >‚# 4¡" ,²"
|
|||
|
|
œ8 ¼¡" L¨" Ö[ 9 / „¨" À?¡" ˆ\ =
|
|||
|
|
|
|||
|
|
|
|||
|
|
, >@¸" Â]L# Ë] ` lÎ" ,Ö" 4å" ´å" Lì" Ö[ % $ö"
|
|||
|
|
|ì" ¸Aå" ˆ\ ? , U O
|
|||
|
|
Bû" Â]L# Ë] q œ‰#
|
|||
|
|
ê³ ýOß\ L# ýO �# Ó 2 B ž#
|
|||
|
|
l | üË Ó ê =
|
|||
|
|
H
|
|||
|
|
% ü£!û ü½!á üÿ!„ ê ñ Ä¡" > E ¼å" Ž\ ´“ ™2 ,í Ü[ Tø L§! €( DÁ! ”= » ”= Ô ”= ËÈ< Ó ×j Û ú- ¶ œ8 a M ùj Ö Ž\ Øk 5 œ8 . ú- ³ ùj G Ž\ { Øk ” ú-
|
|||
|
|
 æl± úl¶ £ ¸ £ u ÿ
|
|||
|
|
÷ Ú
|
|||
|
|
& L# Ë] –@ L# ýO Ú
|
|||
|
|
‚ L# Ë] –H L# ýO Ð •Y ÏYâ šZèÈ<* Ö[ú ˆ\Ö Â]Ü Ö[W ˆ\1È<N Â]=€(¨Ü[®È<f€(ºÜ[ÀÈ<x€(ÌÜ[Ò %„„&
|
|||
|
|
T—&
|
|||
|
|
D—& þq + dê& $ð& r ,ê& 4ð& ¼ê& D÷& õH ; T÷& % d–'
|
|||
|
|
„“'
|
|||
|
|
ê³ ó'Ž) L# " „¼' ,Â' Ås ,¼' È' | TÂ' €C¼' �t K øC°'ã 9
|
|||
|
|
HM ‡u
|
|||
|
|
X a e q
|
|||
|
|
L# $´' � œ8 \â' $ç' r $â'
|
|||
|
|
|
|||
|
|
4ç' dœ,
|
|||
|
|
„™,
|
|||
|
|
ê³ ó'Ž) ª,
|
|||
|
|
«, |¸( D½( õH
|
|||
|
|
$¸( T½( ' Äá( ´á( ¥w ìÝ(
|
|||
|
|
ê³ó'Ž) L# " ´ˆ* \�*
|
|||
|
|
×yœ8
|
|||
|
|
$ˆ* $™* œ8 Œ�* ; ü¸*: ä¸* „ŠäÕ* œ8 ) ü´*?
|
|||
|
|
ê³ó'Ž) L# " ”š+ dš+ ¿}
|
|||
|
|
$§+ ü¸+'
|
|||
|
|
|
|||
|
|
Mó'–,ú}¥y üš+F T+
|
|||
|
|
ªRó'Ž) Mó'–,ú}¥y a ü+3 øDš+G â~ Z ! -
|
|||
|
|
üš+G } ó' ) dì+ \€,
|
|||
|
|
üì+ 4ù+ ©€ F < $œù+ Eà+ i à{ ä Á| ) ý ’,
|
|||
|
|
L# " & ß 9 üÁ$ê V f ! ¡ ± # K
|
|||
|
|
R ü€&« ‚ üÍ'Æ ü×'¼ üˆ+‹ 0 7 Ì Ó !Ç| ¬ò$ œ8 ,â$ ó' 9  œ8 ñ ó' Ÿ ‡t ' ‡t g ‡t 7¨ƒ @ ôƒ I ú- $ œ8 Ï œ8 $Û' D Ž) × Ž) ” ó' \Œ+ Ø… ¹ Ç| ï; _ –¨ E §y M ú- à{ ó' µ ýO Y …P ‘ ó' Š ó' # î ’† ¥†E £ ‡=¢ ‡=×
|
|||
|
|
ᆼ Ú
|
|||
|
|
« –E þqy rN õH- Ås¸ �t† ‡uŒ rï õHs ¥wB —¦ „ŠÀ ¿}o Š¨& â~æ ©€L Á|óó'Îó'Ôó' $Ú+ §y ü»+$ ô»+ ù‹ 6 ß+ M × Ž) º+ –¨ í œ8 q §y ü ‡= §y ù‹} »Š (ˆ0
|
|||
|
|
œ8 p¦0 Å) à` Q V
|
|||
|
|
¨a g l \ y �0 Å � Ž\ › Ž) ¥ Á`Á` œ Ã`è Á] Ä` bufÁÁ] Ê\É:• ê œ8 ñ ¿² ä Å) ñ ü³ ù þ% 0 ú³¿²) Ù²E (Á0 $ X�3
|
|||
|
|
¸ ÉHÉH ’ ÊHœÜ3 ËÚ¢×€JÜ n v œ8 V ^ œ8 h
|
|||
|
|
t
|
|||
|
|
¿² ±¶
|
|||
|
|
ša Ç Ì §
|
|||
|
|
¬ Þ Xˆ2 • �µ ý œ8 . 6 œ8 @ L ¿² AGŠ¶ U [ „ n s | œ8 ‰ �
|
|||
|
|
‹a ¡ § ° Æ0 Î È Î Õ Ž\ â ü³ ë ¦³ ô ú- ü œ8 �µ . œ8 œ8 > ¿² G ׸ S ׸ œ8 F œ8 $ ¿² - ü¸ 6 j þx __self_0Á¬ Ò¸q
|
|||
|
|
¤ ü¸¿²ˆ Š¶¹ü¸¿²á Š¶Ê ä·Ñ $¸4 ,•5 Œ•5 L›5
|
|||
|
|
Ø5 ¨ - \›5 üÔ5&
|
|||
|
|
Æ üÉ52
|
|||
|
|
Á €6 �6 üé3˜ T ü¬4Õ üÇ4º Ž) $�4 ܺ $�4 ܺ ,°4 �µ Ë4 ܺ ò Å) ½ ‡=2 _flagÁ: ; ‘ Öº"ܺÍÜºÓ $¯7 ,Œ8 ŒŒ8 L’8 Öº % \’8 üË8(
|
|||
|
|
Æ üÀ84
|
|||
|
|
Á ù8 ú8 üÞ6œ V ü£7× ü¾7¼ Ž) $”7 ܺ $ø6 ܺ ,§7 �µ Â7 £¼ ç Å) º ‡=/ Æ»3 4 Š ֺܺÆÜºÌ Ìô9
|
|||
|
|
Æ üé9%
|
|||
|
|
Á �: ”: X ü½9W Ž) $Ú9 Å) ` (Í œ8 �î œ8 œ8 & ¿² @†
|
|||
|
|
œ8
|
|||
|
|
ó' &
|
|||
|
|
2 ¿² ‘ –
|
|||
|
|
œa § ¬ œ ¡ o t È Ò Õ ß Ž\ ê æF ñ ¦³ ù œ8 œ8 ó ¿² û §y œ8 Ó ¿² Û ™2 å ™2 ì A þO Z §y¿²R鿲% ÚÁx ¤Ø
|
|||
|
|
Ï ó' ò l ü—[ ³* $É œ8 $¨ ó' ,¼ ÿ
|
|||
|
|
˜ C $ß ,å ¤
|
|||
|
|
Ï ó' ë ° l ® ³* « œ8 © ó' § œ8 } ó' q ÿ
|
|||
|
|
È ˜Ì ö L� œ8 ¬ m üêB œ8 d† æF ,ü , ] œ8 [ m Y œ8 V æF T ] ~ \‘ ó' ¢ n üç; ™2 „ æF ,ú , ^ d ó' u ¡ w n u ™2 r æF p ™2 ² € ¡ LÝ œ8 ¤Ý Dç õH ( Tç ¬Ü ÷ o üJ $Í æF ,à _ œ8 8 õH‚ Œ ¦ ¬ œ8 ¼ µ
|
|||
|
|
¼ º õH à ¸ ð ¾ Â o À ½ æF » œ8 4 œ8 Ñ Ú ú L¶ œ8 ¤¶ DÀ õH ( TÀ Ð p ü… K $§ æF ,� œ8 2 õHn Œ ’ œ8 ¢ ›
|
|||
|
|
¢ õH Æ ž É ¤ p ¢ Ÿ æF � œ8 œ8 ¬ µ Õ üå) ´å
|
|||
|
|
z Œü � �Î s ŸÎ ; ” t üÈL �Î $Ö R �ŸÎ ŸÎ ˆÎƒ Œü
|
|||
|
|
�ŸÎ ŸÎ \¤
|
|||
|
|
r�Î
|
|||
|
|
Ï Ï á Ñÿ
|
|||
|
|
\ Ò˜ \ ‚D9-DV@š�Î ”¤$°
|
|||
|
|
–q¼Ï r 4° �Z¤
|
|||
|
|
±JÙiÙi þ Üi÷ ®i Ýi
|
|||
|
|
end_or_lenÁ®i Þi _markerÁ®i t¸%ýN( ¼Ï � z ~ øZ˜c – ¥ª
|
|||
|
|
àK¸Ð ¼ Ä È Ô æ $œ � ¼Ï LÑ dÝ,â
|
|||
|
|
n�Î $Ý
|
|||
|
|
<â Lœ ü…!´… ˆÎ % œÝ$ê
|
|||
|
|
w�Î
|
|||
|
|
w 4ê üÑ
|
|||
|
|
æïŸÎŸÎ µ N
|
|||
|
|
|
|||
|
|
, üÅ+
|
|||
|
|
R ¬ u üÍß üèÄ ~ ü·D �Î $Ù ŸÎ lì ¸Ð 4 ¸Ð h ¹Ï È ¸Ð Oø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>¥Ò œ ¸Ð ¨ ú- % ¥Ò ÍŸÎ % ŸÎ Ä ŸÎ a �Î Ê ŸÎ © truncatedÁÓ £ ‡=( 'À �ŸÎ ŸÎ¶ r�Î ¹Ï ˆÐu ²ÐQ ÔÑX ÉÒI ˆÎ ¦Óú ÏÓ×
|
|||
|
|
\¨ L¨
|
|||
|
|
u�Î ! ”¨ $´ ¦Ó D 4´ \½ $ ¦Ó $½ 4 ü¨
|
|||
|
|
ÆîŸÎŸÎ m L - 1 \Ì $Ñ ¦Ó $Ì 4Ñ & ü¨/
|
|||
|
|
¡ŸÎŸÎ ‘ W , Ü Ý üög v
|
|||
|
|
$™ þÕ ,� ŸÎ ŸÎ
|
|||
|
|
ŸÎ a þÕ ™ �Î ¢ ŸÎ V žÚ ø ŸÎ U ƒ µ×Ú ¦Ó² ¦Ó“ ±Ør ¦Ó: ¤Ù
|
|||
|
|
�Îâ�Îè L©
|
|||
|
|
|
|||
|
|
$Î ôµ
|
|||
|
|
|
|||
|
|
ĵ
|
|||
|
|
y�Î ; 6 Lá „á$ë ¦Ó % 4ë $ $õ Äá
|
|||
|
|
ŸÎŸÎ ] 2 + 1 L�
|
|||
|
|
|
|||
|
|
|ˆ
|
|||
|
|
ø°�Î üÞe $µ
|
|||
|
|
ø° �Î $ È
|
|||
|
|
|
|||
|
|
|
|||
|
|
É . üìÝ J x ü¥¤ ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>�Î dŽ ŸÎ $ù �Î ŸÎ „ žÚ Í ŸÎ Ö þÕ ï žÚ ¸ �Î r ÓY —Õ| ô ÿÛn ¦Ó+ óÜò�ÎQ�ÎX \æ Læ µ× ”æ $ò ¦Ó ? 4ò Ìß ±Ø $ß @ # üÈ 1 ´È ˆÎ ? þ ÿ üŽ q y �Î $¹ ŸÎ $¤ ŸÎ © ŸÎ × þÕ �Î Ó. ^ µ×1 ¦Ó ±Øï ˆÎÌ�Î�γ |Š! D�! õH $Š! T�! & $¯!
|
|||
|
|
ø° �Î L# X[Ô!
|
|||
|
|
±J¹Ï\Ô! r�Î ¹Ï 1 5 ø[È! N ]b ÔÑ n v z † ˜ $Ì! � ¥Ò \ñ!$ö!
|
|||
|
|
m�Î $ñ!
|
|||
|
|
4ö! $ò"
|
|||
|
|
ø° �Î ü" M
|
|||
|
|
$€" œñ!
|
|||
|
|
œ8œ8
|
|||
|
|
„ 0 ( . dº",¿" ÉÒ $º"
|
|||
|
|
<¿" œº"$Ç" ¦Ó < 4Ç" ü£"+´£" ˆÎ ;
|
|||
|
|
üž"1
|
|||
|
|
ø°�Î
|
|||
|
|
L# ù { ü¢ Ú É üà!ˆ ÿÞ d¾ œ8 $¯ Œ ¸Ð = ¸Ð F ùÔ O ÆÕ X ú- ¥Ò Ë O §y À œ8 È §y w �Î æ ŸÎ þÕ C ÿ
|
|||
|
|
� £ º ‡=( Í» r�Î ¹Ï õH@ ¸äï ÔÑö ñåE Øæã ÉÒ¬ ¦ÓŒ ˆÎn ¬ú$ |ú$
|
|||
|
|
�Î $Š% % •% | üÍ$H þ
|
|||
|
|
‘ � á☚8(„�Î „ß$ þÕ ,Õ$ a áê¥ ÔÌ' ¤Ì'
|
|||
|
|
!�Î $á' % ì' } ü”'X ø  –
|
|||
|
|
|
|||
|
|
|
|||
|
|
ÓûÜÌò‰ �Î ¬¬' þÕ ,¢' u “ì¹ ì÷( Ü÷(
|
|||
|
|
0�Î š) ~ üµ(e * * � , -–
|
|||
|
|
²ãf³°g’B�Î äÐ( K Ùíˆ \ý) $‚* ¦Ó $ý) 4‚* % ŒŒ*
|
|||
|
|
�ŸÎ ŸÎ üý) óÜ o C ! £* üØ)K $î) þÕ ,ä) žÚ ² ŸÎ º žÚ ‘ ŸÎ ™ + L° �ŸÎ ŸÎ ¦Óø óÜ£
|
|||
|
|
\�, L�, µ× ”�, $›, ¦Ó ? 4›, \¤, $©, ¦Ó $¤, 4©, ü�, ÏÓ b A " & \³, $¸, ¦Ó $³, 4¸, & ü�,/ óÜ | M " Ã, Ä, üå*ß €
|
|||
|
|
$ù* þÕ ,ï* žÚ ë ŸÎ ó ŸÎ I þÕ | �Î … ŸÎ > žÚ ë ŸÎ ó O µ×¼ ¦Ó™ ¦Óz ÏÓY ¦Ó, óÜÿ�ÎÝ�Îã \ü- $�. ¦Ó $ü- 4�. ,Š. dŠ. $�. ¦Ó % 4�. Ôü- ±Ø o > ! % Œš.
|
|||
|
|
�ŸÎ ŸÎ üü-/ ¤Ù o C " °. ±. ü¥-Œ �
|
|||
|
|
$Ê- þÕ ,³- �Î ,º- žÚ è ŸÎ ð ŸÎ T ŸÎ ' þÕ @ žÚ â ŸÎ ê P î S � �ŸÎ ŸÎ ¦Ó³ ¦Ó„ ±Øe ¤Ù�Îð�Îö \ç/ $ì/ ¦Ó $ç/ 4ì/ ,õ/ dõ/ $û/ ¦Ó % 4û/ Ôç/ ±Ø o > ! % ,…0
|
|||
|
|
d…0 $‹0 ¦Ó
|
|||
|
|
% 4‹0 $ üç/* óÜ ‡ K " –0 —0 ü’/… ‚ $µ/ þÕ ,ž/ �Î ,¥/ žÚ ŸÎ ŸÎ n ŸÎ A þÕ Z žÚ ì ŸÎ ô þÕ [ î ^ ˜ ¦ÓÄ ¦Ó• ±Øv ¦Ó< óÜ�Îð�Îö $²1 \²1 $·1 ¦Ó & 4·1 ü™1% Ä™1 ÿÛ ; ,‘1 Å1 ' üÍ0x ƒ ýO ã0 �Î LÙ0 �Î Œ ŸÎ ¹ þÕ Ò # V ¦ÓÞ ÿÛ¿�Ρ üà20 $÷2 \÷2 $ü2 ¦Ó & 4ü2 üà2# ´à2 ˆÎ < ,Š3
|
|||
|
|
¢ ,„3
|
|||
|
|
Š�Î ] ? d„3 ,Ø2 —3 ' �3 ü‰2Ž –3 „ 4 ýO ª2 íý L“2 �Î ,ž2 �Î n �Î ŸÎ H þÕ b �Î | H î K ¨ ¦Ó‹ ˆÎl ðÿÑ�Î�Πü�65 $˜6 \˜6 $�6 ¦Ó & 4�6 ü�6# ´�6 ˆÎ < ,°6
|
|||
|
|
¢ T¥6
|
|||
|
|
‹�Î ] ? Œ¥6 ,ù5 ½6 ' µ6 üª5“ ¼6 … 4 ýO Ë5 íý L´5 �Î ,¿5 �Î n �Î ŸÎ H þÕ b �Î | H î K ¨ ¦Ó‹ ˆÎl ÚƒÑ�Î�Πüâ7? $ù7 \ù7 $þ7 ¦Ó & 4þ7 üâ7# ´â7 ˆÎ < ,›8
|
|||
|
|
¢ ¤†8
|
|||
|
|
Œ�Î ] ? ܆8 ,Ú7 ¨8 ' 8 ü‹7� §8 † 4 ýO ¬7 íý L•7 �Î , 7 �Î n �Î ŸÎ H þÕ b �Î | H î K ¨ ¦Ó‹ ˆÎl ćÑ�Î�Π,î9 ”‚: 4‡:
|
|||
|
|
„�Î $‚: ,Ž: l‡: ”³: 4¸:
|
|||
|
|
…�Î $³: ,¿: l¸: Ö: ‡ ü’9Ä ýO ½9 íý L™9 �Î ,¤9 ,±9 ýO ¬ ýO + î . ˜3 h ¢Šê ÖŠ¼ lË; \Ë;
|
|||
|
|
t�Î ,Ã; ß; ' ü‚;] ˆ ýO •; íý L‹; �Î ˆ C ŸŒ¥�Έ
|
|||
|
|
$€= \€= $…= ¦Ó % 4…= ,Ž= dŽ= $”= ¦Ó % 4”= Ô€= ±Ø m > ! üé<2 ´é< ˆÎ = = ¡= + ; ü´<m ‰ �Î $Ú< �Î $Ä< �Î ,Ê< ŸÎ Ò ŸÎ 4 þÕ M ŸÎ þÕ + A î D ¦Óz ¦ÓM ±Ø. ˆÎ�Îð�Îö�Îü�Î
|
|||
|
|
$º> \º> $¿> ¦Ó % 4¿> ,È> dÈ> $Î> ¦Ó % 4Î> Ôº> ÏÓ m > ! ü£>2 ´£> ˆÎ = Ú> Û> + ; üõ=f Š �Î $”> �Î $þ= �Î ,„> ŸÎ Ò ŸÎ 4 þÕ M ŸÎ þÕ + A î D ¦Óz ¦ÓM ÏÓ. ˆÎ�Îð�Îö�Îü�Î $ÌA \ÌA $ÑA ¦Ó % 4ÑA ,ÛA dÛA $áA ¦Ó % 4áA lÚA
|
|||
|
|
š ŸÎ ? " ÜÌA ±Ø • @ ! üµA3 ´µA ˆÎ = íA îA + ;
|
|||
|
|
ü‚Al ‹ �Î $¦A �Î $�A �Î ,–A ŸÎ Ò ŸÎ \ þÕ u ŸÎ ŸÎ C þÕ \ J î M ˆ ¦Ó« ¦Ó~ Å•_ ±Ø> ˆÎ �Î �Î�Î�Î
|
|||
|
|
$ C \ C $¥C ¦Ó % 4¥C ,®C d®C $´C ¦Ó % 4´C Ô C
|
|||
|
|
†ñŸÎŸÎ x I , ü‰C2 ´‰C ˆÎ H ÀC ÁC + ; üÌBu Œ �Î $úB �Î $äB �Î ,êB ŸÎ Ý ŸÎ ? þÕ X ŸÎ þÕ 6 A î D ¦Ó… ¦ÓX Ä™9 ˆÎ�Îð�Îö�Îü�Î $ïD \ïD $ôD ¦Ó % 4ôD dîD Å• 9 üÕD& ÄÕD ÿÛ 8 €E �E ü¯DR � �Î $ÆD �Î $½D ŸÎ £ ŸÎ Ñ þÕ é # T ¦Óö Å•Ö ÿÛº�Λ�Ρ ô* 0ÁHÄJ ÖÇ ô* дJ Ø ô* ÃS %C ÖÇ ô* u8::MAXÁ þ* 0ÁøøJV HÂK ÖÇ ô*þ* ø²K Û þ* ÇS &> ÖÇ ô* _Á 0ÕP ]åP ñ]çª
|
|||
|
|
! ô* ]ÞP
|
|||
|
|
ï_ ë U & S
|
|||
|
|
´¼´¼ K ¶¼”á_ ’raÎ$Àl¸ ‘ ™ ô*ð- ¸
|
|||
|
|
ÆË
|
|||
|
|
Ì` ð- ð- ø
|
|||
|
|
ý ùت. Iݪ
|
|||
|
|
�` æ P ñçª ùݪ) ûP üP ø÷O… ã – � Ž\ X¬P ë (“P ó¢ PšP ó¢ í –½–½ ArgumentsÁ ˜½ templateÁÁ] ™½þÁ] ¤í¤>ÜIšÐ ì é - é E ¦¡ð- M¦¡ - ï¡ _ †¥ k é t É ælË þ˜ þ¤ / ‚¡� œ¢¿ í¢¹ó¢|ó¢ƒ 0�R _R ñ_çª
|
|||
|
|
! þ* _¦R
|
|||
|
|
ï_ ê¦ U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ùت. Iݪ í¢ é ñçª ùݪ) ÃR ÄR ø¿Q… æ . 5 Ž\ XôQ ê¦ (ÛQ ó¢ PâQ ’¤ ‚ ž¤ � è¦ v è¦ Ž †¥ ˆ¦¡ h ï¡ š ¯¥ £ è¦ ¬ i ælk þÐ þÜ Ï �§Æ œ¢ö í¢Oó¢ó¢" À+ 0Á % ðÈ À+ ì * À+ ÏS ?^ ðÈ À+ u16::MAXÁ Ê+ 0Á ðÈ À+Ê+ ï ( Ê+ ÔS =V ðÈ À+ _Á aåP ñaçª
|
|||
|
|
! À+ aÞP
|
|||
|
|
ï_ ‚ U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ùت. Iݪ í¢ ñçª ùݪ) ° ® É ÷ ¼ ) 0 Ž\ ª ‚ ¨ ó¢ ¦ ’¤ Ž ž¤ ‘ € k € ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ € ¡
|
|||
|
|
æl þÇ þÓ u ™¾ œ¢î í¢Gó¢Âó¢É F cR ñcçª
|
|||
|
|
! Ê+ c¦R
|
|||
|
|
ï_ ®± U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ùت. Iݪ í¢ - ñçª ùݪ) E C ^ B ú Q ) 0 Ž\ ? ®± = ó¢ ; ’¤ » ž¤ ‘ ¬± k ¬± ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ ¬± ¡ ¢ æl¥ þÇ þÓ
|
|||
|
|
ű¾ œ¢î í¢Gó¢Wó¢^ Œ, 0ÁZ c ‰Ê Œ, Y € h Œ, ÝS } œ ‰Ê Œ, u32::MAXÁ –, 0Á^ [ ‰Ê Œ,–, Y ƒ h –, âS } – ‰Ê Œ, _Á Y eåP ñeçª
|
|||
|
|
! Œ, eÞP
|
|||
|
|
ï_ · U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ùت. Iݪ í¢ @ ñçª ùݪ) ð
|
|||
|
|
î
|
|||
|
|
í
|
|||
|
|
‹ ü
|
|||
|
|
) 0 Ž\ ê
|
|||
|
|
· è
|
|||
|
|
ó¢ æ
|
|||
|
|
’¤ Î ž¤ ‘ À· k À· ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ À· ¡ M ælP þÇ þÓ µ Ù·¾ œ¢î í¢Gó¢ ó¢ †
|
|||
|
|
gR ñgçª
|
|||
|
|
! –, g¦R
|
|||
|
|
ï_ î» U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ù ت. I ݪ í¢ m ñ çª ù ݪ) …
|
|||
|
|
ƒ
|
|||
|
|
ž
|
|||
|
|
‚
|
|||
|
|
Ž ‘
|
|||
|
|
) 0 Ž\
|
|||
|
|
î» }
|
|||
|
|
ó¢ {
|
|||
|
|
’¤ û ž¤ ‘ ì» k ì» ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ ì» ¡ â
|
|||
|
|
ælå
|
|||
|
|
þÇ þÓ J …¼¾ œ¢î í¢Gó¢— ó¢ž Ø, 0Áž § ¢Ë Ø, � ” ¬ Ø, ëS Áà ¢Ë Ø, u64::MAXÁ â, 0Á¦ £ ¢Ë Ø,â, ¡ — ° â, ðS ÅÞ ¢Ë Ø, _Á ¡ iåP ñiçª
|
|||
|
|
! Ø, iÞP
|
|||
|
|
ï_ ŠÂ U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ù ت. I ݪ í¢ ˆ ñ çª ù ݪ) 8 6 Q 5 Ÿ D ) 0 Ž\ 2 ŠÂ 0 ó¢ . ’¤ ž¤ ‘ ˆÂ k ˆÂ ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ ˆÂ ¡ • æl˜ þÇ þÓ ý ¡Â¾ œ¢î í¢Gó¢Jó¢Q Î kR ñkçª
|
|||
|
|
! â, k¦R
|
|||
|
|
ï_ ¶Æ U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ù ت. I ݪ í¢ µ ñ!çª ù ݪ) Í Ë æ Ê ¢ Ù ) 0 Ž\ Ç ¶Æ Å ó¢ à ’¤ C ž¤ ‘ ´Æ k ´Æ ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ ´Æ ¡ * æl- þÇ þÓ ’ Íƾ œ¢î í¢Gó¢ßó¢æ ¤- 0Áî ÷ »Ì ¤- í ¨ ü ¤- $ùS 0 »Ì ¤- u128::MAXÁ ®- 0Áÿ ü »Ì ¤-®- ú « ®- $ÿS 7 »Ì ¤- _Á ú måP ñmçª
|
|||
|
|
! ¤- mÞP
|
|||
|
|
ï_ ãÌ U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ù"ت. I"ݪ í¢ á ñ#çª ù"ݪ) ‘ � ª Ž ³ � ) 0 Ž\ ‹ ãÌ ‰ ó¢ ‡ ’¤ o ž¤ ‘ áÌ k áÌ ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ áÌ ¡ î ælñ þÇ þÓ V ú̾ œ¢î í¢Gó¢£ó¢ª ' oR ñoçª
|
|||
|
|
! ®- o¦R
|
|||
|
|
ï_ �Ñ U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ù$ت. I$ݪ í¢ ñ%çª ù$ݪ) & $ ? # ¶ 2 ) 0 Ž\ �Ñ ó¢ ’¤ œ ž¤ ‘ �Ñ k �Ñ ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ �Ñ ¡ ƒ æl† þÇ þÓ ë ¦Ñ¾ œ¢î í¢Gó¢8ó¢? ð- 0Á? H ÔÍ ð- > ¼ M ð- ,‰T b� ÔÍ ð-
|
|||
|
|
usize::MAXÁ ú- 0ÁI F ÔÍ ð-ú- D ¿ S ú- ,�T h� ÔÍ ð- _Á D qåP ñqçª
|
|||
|
|
! ð- qÞP
|
|||
|
|
ï_ × U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ù&ت. I&ݪ í¢ + ñ'çª ù&ݪ) Û Ù ô Ø Ç ç ) 0 Ž\ Õ × Ó ó¢ Ñ ’¤ ¹ ž¤ ‘ «× k «× ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ «× ¡ 8 æl; þÇ þÓ Ä×¾ œ¢î í¢Gó¢íó¢ô q sR ñsçª
|
|||
|
|
! ú- s¦R
|
|||
|
|
ï_ ÙÛ U & S
|
|||
|
|
¦¡ c k ï¡ z
|
|||
|
|
ˆ�œ¢ š
|
|||
|
|
Ÿ ¨ ù(ت. I(ݪ í¢ X ñ)çª ù(ݪ) p n ‰ m Ê | ) 0 Ž\ j ÙÛ h ó¢ f ’¤ æ ž¤ ‘ ×Û k ×Û ƒ †¥ }¦¡ ] ï¡ � ¯¥ ˜ ×Û ¡ Í ælÐ þÇ þÓ 5 ðÛ¾ œ¢î í¢Gó¢‚ó¢‰ ¬�0
|
|||
|
|
Á Â % Ž) 0 Å) 7 > L
|
|||
|
|
Á b  o Ž) z Å) � ˆ 5\¤±¸»“ ™$é: Ž á $ï: Ï �,õ: q ¦Dä= – ªÐD†` « ß|ã ¬ õtˆ¿ Š„„ ® ¡ÔñÍ ¯ Â|ýá ° àÌõ ² �ôö ³ §´•! ´ ÅÜÿE µ èÔ‰U ¶ ŠìÉ… · ¶Ü® ¹ ÙÄœ º ˆ ă ½ ÿôå$ ¾ ú üü-" ¿ ¼
|
|||
|
|
üÞ7! À üÓ¼â üÓÜ5 ×5
|
|||
|
|
Generate types for C-style flags with ergonomic APIs.
|
|||
|
|
|
|||
|
|
# Getting started
|
|||
|
|
|
|||
|
|
Add `bitflags` to your `Cargo.toml`:
|
|||
|
|
|
|||
|
|
```toml
|
|||
|
|
[dependencies.bitflags]
|
|||
|
|
version = "2.10.0"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Crate features
|
|||
|
|
|
|||
|
|
The `bitflags` library defines a few Cargo features that you can opt-in to:
|
|||
|
|
|
|||
|
|
- `std`: Implement the `Error` trait on error types used by `bitflags`.
|
|||
|
|
- `serde`: Support deriving `serde` traits on generated flags types.
|
|||
|
|
- `arbitrary`: Support deriving `arbitrary` traits on generated flags types.
|
|||
|
|
- `bytemuck`: Support deriving `bytemuck` traits on generated flags types.
|
|||
|
|
|
|||
|
|
## Generating flags types
|
|||
|
|
|
|||
|
|
Use the [`bitflags`] macro to generate flags types:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
use bitflags::bitflags;
|
|||
|
|
|
|||
|
|
bitflags! {
|
|||
|
|
pub struct Flags: u32 {
|
|||
|
|
const A = 0b00000001;
|
|||
|
|
const B = 0b00000010;
|
|||
|
|
const C = 0b00000100;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
See the docs for the `bitflags` macro for the full syntax.
|
|||
|
|
|
|||
|
|
Also see the [`example_generated`](./example_generated/index.html) module for an example of what the `bitflags` macro generates for a flags type.
|
|||
|
|
|
|||
|
|
### Externally defined flags
|
|||
|
|
|
|||
|
|
If you're generating flags types for an external source, such as a C API, you can define
|
|||
|
|
an extra unnamed flag as a mask of all bits the external source may ever set. Usually this would be all bits (`!0`):
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
pub struct Flags: u32 {
|
|||
|
|
const A = 0b00000001;
|
|||
|
|
const B = 0b00000010;
|
|||
|
|
const C = 0b00000100;
|
|||
|
|
|
|||
|
|
// The source may set any bits
|
|||
|
|
const _ = !0;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Why should you do this? Generated methods like `all` and truncating operators like `!` only consider
|
|||
|
|
bits in defined flags. Adding an unnamed flag makes those methods consider additional bits,
|
|||
|
|
without generating additional constants for them. It helps compatibility when the external source
|
|||
|
|
may start setting additional bits at any time. The [known and unknown bits](#known-and-unknown-bits)
|
|||
|
|
section has more details on this behavior.
|
|||
|
|
|
|||
|
|
### Custom derives
|
|||
|
|
|
|||
|
|
You can derive some traits on generated flags types if you enable Cargo features. The following
|
|||
|
|
libraries are currently supported:
|
|||
|
|
|
|||
|
|
- `serde`: Support `#[derive(Serialize, Deserialize)]`, using text for human-readable formats,
|
|||
|
|
and a raw number for binary formats.
|
|||
|
|
- `arbitrary`: Support `#[derive(Arbitrary)]`, only generating flags values with known bits.
|
|||
|
|
- `bytemuck`: Support `#[derive(Pod, Zeroable)]`, for casting between flags values and their
|
|||
|
|
underlying bits values.
|
|||
|
|
|
|||
|
|
You can also define your own flags type outside of the [`bitflags`] macro and then use it to generate methods.
|
|||
|
|
This can be useful if you need a custom `#[derive]` attribute for a library that `bitflags` doesn't
|
|||
|
|
natively support:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
# use std::fmt::Debug as SomeTrait;
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
#[derive(SomeTrait)]
|
|||
|
|
pub struct Flags(u32);
|
|||
|
|
|
|||
|
|
bitflags! {
|
|||
|
|
impl Flags: u32 {
|
|||
|
|
const A = 0b00000001;
|
|||
|
|
const B = 0b00000010;
|
|||
|
|
const C = 0b00000100;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Adding custom methods
|
|||
|
|
|
|||
|
|
The [`bitflags`] macro supports attributes on generated flags types within the macro itself, while
|
|||
|
|
`impl` blocks can be added outside of it:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
// Attributes can be applied to flags types
|
|||
|
|
#[repr(transparent)]
|
|||
|
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|||
|
|
pub struct Flags: u32 {
|
|||
|
|
const A = 0b00000001;
|
|||
|
|
const B = 0b00000010;
|
|||
|
|
const C = 0b00000100;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Impl blocks can be added to flags types
|
|||
|
|
impl Flags {
|
|||
|
|
pub fn as_u64(&self) -> u64 {
|
|||
|
|
self.bits() as u64
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Working with flags values
|
|||
|
|
|
|||
|
|
Use generated constants and standard bitwise operators to interact with flags values:
|
|||
|
|
|
|||
|
|
```rust
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
# bitflags! {
|
|||
|
|
# #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
|
|||
|
|
# pub struct Flags: u32 {
|
|||
|
|
# const A = 0b00000001;
|
|||
|
|
# const B = 0b00000010;
|
|||
|
|
# const C = 0b00000100;
|
|||
|
|
# }
|
|||
|
|
# }
|
|||
|
|
// union
|
|||
|
|
let ab = Flags::A | Flags::B;
|
|||
|
|
|
|||
|
|
// intersection
|
|||
|
|
let a = ab & Flags::A;
|
|||
|
|
|
|||
|
|
// difference
|
|||
|
|
let b = ab - Flags::A;
|
|||
|
|
|
|||
|
|
// complement
|
|||
|
|
let c = !ab;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
See the docs for the [`Flags`] trait for more details on operators and how they behave.
|
|||
|
|
|
|||
|
|
# Formatting and parsing
|
|||
|
|
|
|||
|
|
`bitflags` defines a text format that can be used to convert any flags value to and from strings.
|
|||
|
|
|
|||
|
|
See the [`parser`] module for more details.
|
|||
|
|
|
|||
|
|
# Specification
|
|||
|
|
|
|||
|
|
The terminology and behavior of generated flags types is
|
|||
|
|
[specified in the source repository](https://github.com/bitflags/bitflags/blob/main/spec.md).
|
|||
|
|
Details are repeated in these docs where appropriate, but is exhaustively listed in the spec. Some
|
|||
|
|
things are worth calling out explicitly here.
|
|||
|
|
|
|||
|
|
## Flags types, flags values, flags
|
|||
|
|
|
|||
|
|
The spec and these docs use consistent terminology to refer to things in the bitflags domain:
|
|||
|
|
|
|||
|
|
- **Bits type**: A type that defines a fixed number of bits at specific locations.
|
|||
|
|
- **Flag**: A set of bits in a bits type that may have a unique name.
|
|||
|
|
- **Flags type**: A set of defined flags over a specific bits type.
|
|||
|
|
- **Flags value**: An instance of a flags type using its specific bits value for storage.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
struct FlagsType: u8 {
|
|||
|
|
// -- Bits type
|
|||
|
|
// --------- Flags type
|
|||
|
|
const A = 1;
|
|||
|
|
// ----- Flag
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
let flag = FlagsType::A;
|
|||
|
|
// ---- Flags value
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Known and unknown bits
|
|||
|
|
|
|||
|
|
Any bits in a flag you define are called _known bits_. Any other bits are _unknown bits_.
|
|||
|
|
In the following flags type:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
struct Flags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 << 1;
|
|||
|
|
const C = 1 << 2;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
The known bits are `0b0000_0111` and the unknown bits are `0b1111_1000`.
|
|||
|
|
|
|||
|
|
`bitflags` doesn't guarantee that a flags value will only ever have known bits set, but some operators
|
|||
|
|
will unset any unknown bits they encounter. In a future version of `bitflags`, all operators will
|
|||
|
|
unset unknown bits.
|
|||
|
|
|
|||
|
|
If you're using `bitflags` for flags types defined externally, such as from C, you probably want all
|
|||
|
|
bits to be considered known, in case that external source changes. You can do this using an unnamed
|
|||
|
|
flag, as described in [externally defined flags](#externally-defined-flags).
|
|||
|
|
|
|||
|
|
## Zero-bit flags
|
|||
|
|
|
|||
|
|
Flags with no bits set should be avoided because they interact strangely with [`Flags::contains`]
|
|||
|
|
and [`Flags::intersects`]. A zero-bit flag is always contained, but is never intersected. The
|
|||
|
|
names of zero-bit flags can be parsed, but are never formatted.
|
|||
|
|
|
|||
|
|
## Multi-bit flags
|
|||
|
|
|
|||
|
|
Flags that set multiple bits should be avoided unless each bit is also in a single-bit flag.
|
|||
|
|
Take the following flags type as an example:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
struct Flags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 | 1 << 1;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
The result of `Flags::A ^ Flags::B` is `0b0000_0010`, which doesn't correspond to either
|
|||
|
|
`Flags::A` or `Flags::B` even though it's still a known bit.
|
|||
|
|
Á 5\¤±¸»“u ™v Ž á u Ï �t q ¦s – ªÐr « ßq ¬ õp Šn ® ¡l ¯ Âj ° àh ² �g ³ §f ´ Åe µ èd ¶ Šc · ¶a ¹ Ù` º ˆ _ ½ ÿ^ ¾ ú ] ¿ ¼
|
|||
|
|
[ À Ñ Ô × Üà:Î Ñ Ã Æ ¸ » dþ: ü Q L
|
|||
|
|
Yield the bits of a source flags value in a set of contained flags values.
|
|||
|
|
Á $†; *á $_ Ï �,e q
|
|||
|
|
¤W)+Ü— ün¨ £
|
|||
|
|
An iterator over flags values.
|
|||
|
|
|
|||
|
|
This iterator will yield flags values for contained, defined flags first, with any remaining bits yielded
|
|||
|
|
as a final flags value.
|
|||
|
|
Á $¢ ‰ ©âó' § ó'<ªÀ' á☚8(„
|
|||
|
|
&( œ¹,¹ €(TÒ$Ò ´á ‰ ÅŸ æ qó' ,éÀ' üþ$ Œ Î Îó' À' —
|
|||
|
|
ó'ŸĊ ‰ ÅŸ � ÕŸ<’À' üà\¡ Ï Ò Ù 8° 4Ó tÍœí Ö3 ó'ó'À'
|
|||
|
|
ó'Â[
|
|||
|
|
d
|
|||
|
|
müÇ# ‰ ÅŸ Ì Ö ,ÏÀ' ßK àK Lñ$ö ó'ü…($ˆ Ï ÏÀ'ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE> À'ßK �
|
|||
|
|
ó'$’üø
|
|||
|
|
ü¥ Ò Í
|
|||
|
|
An iterator over flags values.
|
|||
|
|
|
|||
|
|
This iterator only yields flags values for contained, defined, named flags. Any remaining bits
|
|||
|
|
won't be yielded, but can be found with the [`IterNames::remaining`] method.
|
|||
|
|
Á Lƒ ‰ ÅŸ � ÕŸ<�€( ÓûÜÌò‰ &( ÌŸ,Ÿ Ë¢T¾ ¾ ð-LÎ4Î ó'dÝLÝ ó'Üî ‰ ÅŸ ó Ö ,ö€(! ü�$ ž Ð Ðó' €( © µ1ÂÜ ì€ ‰ # # ÅŸ … ÕŸ<ˆ€($% üÙ\¡ È Ë Ò 8° 4Ì tÆœæ Ë¢ó'ó'€( " " â2¤
|
|||
|
|
|
|||
|
|
¶ ìË ü³J G Get a flags value of any remaining bits that haven't been yielded yet.Á ‚Ë üŠ> ; Once the iterator has finished, this method can be used toÁ üÍB ? check whether or not there are any bits that didn't correspondÁ ü”2 / to a contained, defined, named flag remaining.ÁLÒ Ñ Ñ€( Ñó' " Ü " ©9$ÝüŒ( ‰ ' ' ÅŸ ‘ Ö ,”€(() ßK àK ) L»$À & & ó'üß($â Ò Ò€(ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE> €(ßK & ç &
|
|||
|
|
)ó'$ìü“"' üØ º µ
|
|||
|
|
An iterator over all defined named flags.
|
|||
|
|
|
|||
|
|
This iterator will yield flags values for all defined named flags, regardless of
|
|||
|
|
whether they are contained in a particular flags value.
|
|||
|
|
Á „ž" ‰ + + ÅŸ ¯" ÕŸ<²"Ñ( ²ãf³°g’B ,-$& ÌÁ",Á" * * Ë¢Tà" à" * * ð-üï"" ‰ / / ÅŸ ô" Ö ,÷"Ñ(0 ܘ# ¦# Ñ( . .
|
|||
|
|
0ó'ü•$/ ‰ 2 2 ÅŸ š$ Ö ,�$Ñ(34 ßK àK 4 LË$$Ð$ 1 1 »®üï$($ò$ Ó ÓÑ(ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE> Ñ(ßK 1 ÷$ 1
|
|||
|
|
4ó'$ü$tŒ; ü Á ¼
|
|||
|
|
Parsing flags from text.
|
|||
|
|
|
|||
|
|
Format and parse a flags value as text using the following grammar:
|
|||
|
|
|
|||
|
|
- _Flags:_ (_Whitespace_ _Flag_ _Whitespace_)`|`*
|
|||
|
|
- _Flag:_ _Name_ | _Hex Number_
|
|||
|
|
- _Name:_ The name of any defined flag
|
|||
|
|
- _Hex Number_: `0x`([0-9a-fA-F])*
|
|||
|
|
- _Whitespace_: (\s)*
|
|||
|
|
|
|||
|
|
As an example, this is how `Flags::A | Flags::B | 0x0c` can be represented as text:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
A | B | 0x0c
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Alternatively, it could be represented without whitespace:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
A|B|0x0C
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Note that identifiers are *case-sensitive*, so the following is *not equivalent*:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
a|b|0x0C
|
|||
|
|
```
|
|||
|
|
Á 4”; <?CFHKNQÁÂÆÍ$ö Á] 5 7 WriteÁ,ü ‹` 5 8™$‘ Ž 5 : �,— q 5 ; Äê W ð EG¤‰ :<(*ü–t ü u p
|
|||
|
|
Write a flags value as text.
|
|||
|
|
|
|||
|
|
Any bits that aren't part of a contained flag will be formatted as a hex number.
|
|||
|
|
ÁL� Ô Ôó' Ü[Ž\ ‰ = ” > > = ¸ ÅŸ § ©âÜ[ TÈ Ö ,ª NÙ= D� ‹`Ü[ ,Í «ŽÂ˜4æl4À KM HJ ü´\ ü¡’ �
|
|||
|
|
Parse a flags value from text.
|
|||
|
|
|
|||
|
|
This function will fail on any names that don't correspond to defined flags.
|
|||
|
|
Unknown bits will be retained.
|
|||
|
|
ÁD» Õ Õ Ç| ‰ @ @ Õ ÅŸ Ä Ö ,Ç QÙ= D‡ Ñ�’†ë@%' ¨ ? <closure_kind>Á A <closure_signature>Á A <upvars>Á A A ? ÑyÉ ?ñ¾ B ‰¿ B ¦¿ B B ? ©~ü‡y üÈ> 9
|
|||
|
|
Write a flags value as text, ignoring any unknown bits.
|
|||
|
|
Á”Ž Ö Öó' Ü[Ž\ ‰ D ” E D E ² ÅŸ ¡ ×¼T¾ Ö ,¤ ï¼D÷ ý¼,Ã
|
|||
|
|
Có'Ü[Â>GælGG<> AC üÔ e ü ‘ Œ
|
|||
|
|
Parse a flags value from text.
|
|||
|
|
|
|||
|
|
This function will fail on any names that don't correspond to defined flags.
|
|||
|
|
Unknown bits will be ignored.
|
|||
|
|
ÁŒÛ × × Ç| ‰ G G þ ÅŸ í Ö ,ð °¿D°
|
|||
|
|
Fó'’†eI#% üË ^ üû O J
|
|||
|
|
Write only the contained, defined, named flags in a flags value as text.
|
|||
|
|
Á„Ò Ø Øó' Ü[Ž\ ‰ I ” J J I ô ÅŸ ã ×¼T„ Ö ,æ ý¼,‰
|
|||
|
|
Hó'Ü[ÂûMæl4ü 57 :< üÁ$F ü # ›
|
|||
|
|
Parse a flags value from text.
|
|||
|
|
|
|||
|
|
This function will fail on any names that don't correspond to defined flags.
|
|||
|
|
This function will fail to parse hex values.
|
|||
|
|
Á|È$ Ù Ù Ç| ‰ L L é$ ÅŸ Ø$ Ö ,Û$
|
|||
|
|
Kó'’†çU ¸+ Kñ¾ M ‰¿ M ¦¿ M M K –¨”’- ü,d _
|
|||
|
|
Encode a value as a hex string.
|
|||
|
|
|
|||
|
|
Implementors of this trait should not write the `0x` prefix.
|
|||
|
|
Á Dœ- N N ªâ�Î ü’-x N Ë Ë OO O üË-= Ü«- Write the value as hex.ÁLÎ- Ú Ú�Î æŽ\ Næ P P ç- N ©â¨Ì Ø- ‹`¨Ì TÛ-
|
|||
|
|
O�ΨÌ$è- æl4î- /1 ”´. üŒ.' "
|
|||
|
|
Parse a value from a hex string.
|
|||
|
|
Á D¾. Q Q Ëü´.‘ Q Ë Ë RR R üï.T ìÍ. Parse the value from hex.ÁLò. Û Û ê³í³ î³Ò ï³ì ð³ ñ³“ò³ì äs{ ©¶‘�ÎŽ) Q ƒ/ Q ©â�Î ,½/
|
|||
|
|
R�Î’†,ü. |¦3 Ž)TVX üé38 ü¼3( % An invalid hex flag was encountered.Á„ð3 ܺŽ) S ¨ U U S ©âܺ Œ‡4 å`ܺ dŒ4
|
|||
|
|
Tܺ‡=‰]#% üÞ6: ü‡6R O A named flag that doesn't correspond to any on the flags type was encountered.Á”å6 ܺŽ) S ¨ W W S ÷ÐŒþ6 ˆÑdƒ7
|
|||
|
|
Vܺ‡=Ø^ ü½9! ü€98 5 A hex or named flag wasn't found between separators.ÁTÊ9 Ž) S S ¥wü˜: Ž)Z æ` Z ü¿:8 Â: Ü Ý Þ ÜŽ) ÝÁ`Á` œ Ã`è Á] Ä`DzÁ] Ê\É:• ÞŽ\ Y Æ: Y
|
|||
|
|
Z $Ç: þ Í: üë@% » Õ@ Ø@ è@ 8¶ <Ù@ á@ 7“ ,ã@ ¼Ó@ Ž) T�; 4¡; qŽ‘“–Ÿ ÏÍ Á] \ ^ BitAndÁ4 Ãî \ ` BitOrÁ,' ãï \ a BitXorÁ4. ƒñ \ b NotÁ 6 ˜ \ c£ $Q \ e¿ Td Á \ gîDp Q \ hÇDz N \ iü9·¹¥§‘“|~jlüDB`bUWGI:<|“ ‰ k k ÅŸ ˜³*lmnop ü—6 ü©i d
|
|||
|
|
Define a flag.
|
|||
|
|
|
|||
|
|
If `name` is non-empty then the flag is named, otherwise it's unnamed.
|
|||
|
|
Á ¤ ½®ó'³* j j
|
|||
|
|
ló'ÿ
|
|||
|
|
†a˜�aüê( üøm h
|
|||
|
|
Get the name of this flag.
|
|||
|
|
|
|||
|
|
If the flag is unnamed then the returned string will be empty.
|
|||
|
|
Á$÷ ß ß³* ½® j ü j ÊH$ýüç ü²0 +
|
|||
|
|
Get the flags value of this flag.
|
|||
|
|
Á,ô à à³* àó' j ú j ¬I$ûü$ ü¨€ {
|
|||
|
|
Whether the flag is named.
|
|||
|
|
|
|||
|
|
If [`Flag::name`] returns a non-empty string then this method will return `true`.
|
|||
|
|
ÁDº á á³* j à j ÈT$Äü… & üýƒ ~
|
|||
|
|
Whether the flag is unnamed.
|
|||
|
|
|
|||
|
|
If [`Flag::name`] returns a non-empty string then this method will return `false`.
|
|||
|
|
ÁT’ â â³* j � j
|
|||
|
|
pó'$ž üï üÔ š •
|
|||
|
|
A set of defined flags using a bits type as storage.
|
|||
|
|
|
|||
|
|
## Implementing `Flags`
|
|||
|
|
|
|||
|
|
This trait is implemented by the [`bitflags`](macro.bitflags.html) macro:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
use bitflags::bitflags;
|
|||
|
|
|
|||
|
|
bitflags! {
|
|||
|
|
struct MyFlags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 << 1;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
It can also be implemented manually:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
use bitflags::{Flag, Flags};
|
|||
|
|
|
|||
|
|
struct MyFlags(u8);
|
|||
|
|
|
|||
|
|
impl Flags for MyFlags {
|
|||
|
|
const FLAGS: &'static [Flag<Self>] = &[
|
|||
|
|
Flag::new("A", MyFlags(1)),
|
|||
|
|
Flag::new("B", MyFlags(1 << 1)),
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
type Bits = u8;
|
|||
|
|
|
|||
|
|
fn from_bits_retain(bits: Self::Bits) -> Self {
|
|||
|
|
MyFlags(bits)
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
fn bits(&self) -> Self::Bits {
|
|||
|
|
self.0
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Using `Flags`
|
|||
|
|
|
|||
|
|
The `Flags` trait can be used generically to work with any flags types. In this example,
|
|||
|
|
we can count the number of defined named flags:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::{bitflags, Flags};
|
|||
|
|
fn defined_flags<F: Flags>() -> usize {
|
|||
|
|
F::FLAGS.iter().filter(|f| f.is_named()).count()
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
bitflags! {
|
|||
|
|
struct MyFlags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 << 1;
|
|||
|
|
const C = 1 << 2;
|
|||
|
|
|
|||
|
|
const _ = !0;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
assert_eq!(3, defined_flags::<MyFlags>());
|
|||
|
|
```
|
|||
|
|
Á ,ù q q ÍÏ,€ �Î<ˆ q ÍÏ" Óé ÍÏ. Óé)rstuvwxyz{|}~€�‚ƒ„…†‡ˆ‰Š‹Œ�rstuvwxyz{|}~€�‚ƒ„…†‡ˆ‰Š‹Œ� ©âŸÎ „ƒ ŽŸÎ $Ž Ûê ìê � Œ y „ | ‡ t Š w ‚ � z … } ˆ u € ‹ x ƒ { † ~ ‰ v ü¸" ì– The set of defined flags.Á,¾ q q »Ï |ƒ ìá The underlying bits type.Á$ˆ q q ”È ü™* ' Get a flags value with all bits unset.Á,Ë �Î q q ŸŒ„Í üš. + Get a flags value with all known bits set.Á Ð �Î q q µ×üö' ü²? < This method will return `true` if any unknown bits are set.Á¬ù ã ã�Î q � q
|
|||
|
|
v�Î$�ìÚ üã" Get the underlying bits value.Á ŠË ü’C @ The returned value is exactly the bits set in this flags value.Á$Ý ä ä�Î ŸÎ q â q ¦Ó$ãüì. ôý Convert from a bits value.Á Ë ü¨? < This method will return `None` if any unknown bits are set.ÁLï ŸÎÿÞ q q
|
|||
|
|
x�ÎÓQoüŽ / üÏ : 7 Convert from a bits value, unsetting any unknown bits.Á”‘ ŸÎ�Î q q ÿÛÓäpü° . ü… & # Convert from a bits value exactly.Á„³ ŸÎ�Î q q ˆÎÓ$Ä ü¢ ( üä F C Get a flags value with the bits of a flag with the given name set.Á ¯ Ë ü· @ = This method will return `None` if `name` is empty or doesn'tÁ üü ! correspond to any named flag.ÁL¥ å å ÿÞ q µ q
|
|||
|
|
{�Îÿ
|
|||
|
|
×süÍ$" ü‚#* ' Yield a set of contained flags values.Á ±#Ë ü¹#V S Each yielded flags value will correspond to a defined named flag. Any unknown bitsÁ ü”$4 1 will be yielded together as a final flags value.Á$Ð$ æ æ�Î —ë q Õ$ q
|
|||
|
|
|�Î$Ö$ü”'- ü›%0 - Yield a set of contained named flags values.Á Ð%Ë üØ%Z W This method is like [`Flags::iter`], except only yields bits in contained named flags.Á ü·&X U Any unknown bits, or bits not corresponding to a contained flag will not be yielded.ÁT—' ç ç�Î Éì q ¢' q
|
|||
|
|
}�Î$£'üµ(7 üò'> ; Yield a set of all named flags defined by [`Self::FLAGS`].Á”¸( ˆî q q
|
|||
|
|
~�ÎÔØ) ü )3 0 Whether all bits in this flags value are unset.ÁDÛ) è è�Î q ä) q
|
|||
|
|
�Î$å)Äå* ü©*7 4 Whether all known bits in this flags value are set.Á4è* é é�Î q ï* q
|
|||
|
|
€�Î$ð*ü¥-H üÊ,V S Whether any set bits in a source flags value are also set in a target flags value.ÁT¨- ê ê�Î �Î q ³- q ÍÏ,ç-
|
|||
|
|
��Î$´-î {ü’/F ü·.V S Whether all set bits in a source flags value are also set in a target flags value.ÁD•/ ë ë�Î �Î q ž/ q ÍÏ,Ò/
|
|||
|
|
‚�Î$Ÿ/î }üÍ05 ü�0+ ( Remove any unknown bits from the flags.ÁDÐ0 ì ì�ÎýO q Ù0 q ÍÏ,ü0
|
|||
|
|
ƒ�Î$Þ0ü‰2@ üË19 6 The bitwise or (`|`) of the bits in two flags values.Á4Œ2 í í�Î�ÎýO q “2 q ÍÏ,Ã2¢Š$˜2î &€üª5@ ü�3` ] The intersection of a source flags value with the complement of a target flags value (`&!`).Á ‚4Ë üŠ4W T This method is not equivalent to `self & !other` when `other` has unknown bits set.Á üæ4? < `remove` won't truncate `other`, but the `!` operator will.Á45 î î�Î�ÎýO q ´5 q ÍÏ,ä5ÖŠ$¹5î a�ü‹7@ üÃ6C @ The bitwise exclusive-or (`^`) of the bits in two flags values.Á4Ž7 ï ï�Î�ÎýO q •7 q ÍÏ,Å7
|
|||
|
|
†�Î$š7î +€ü’9J ü®8_ \ Call [`Flags::insert`] when `value` is `true` or [`Flags::remove`] when `value` is `false`.Á •9 ð ð�Î�Î ýO q ™9 q ÍÏ,Ö9
|
|||
|
|
‡�Î$ž9î ǘÆü‚;2 üÜ:! Unsets all bits in the flags.Á,…; ñ ñ�ÎýO q ‹; q ÍÏ,®;
|
|||
|
|
ˆ�Î$�;ü´<* üå;: 7 The bitwise and (`&`) of the bits in two flags values.Á ,\¤< d·< �Î�Î�Î q q
|
|||
|
|
‰�Φ~î £~üõ=# ü§=9á‚ ,\å= ,ø= �Î�Î�Î q q ðÿ=}î :}ü‚A( üá>`…„ Æ?Ë üÎ?Wù„ üª@C @ `difference` won't truncate `other`, but the `!` operator will.Á ,\ò@ T…A �Î�Î�Î q q Úƒ|î
|
|||
|
|
|üÌB2 üôACƒ‡ ,\¼B ¤ÏB �Î�Î�Î q q ć‰zî †zܯD üÇCS P The bitwise negation (`!`) of the bits in a flags value, truncating the result.Á ,\ŸD T²D �Î�Î q q
|
|||
|
|
��ÎÊyüÆEº ü…E@ ;
|
|||
|
|
A bits type that can be used as storage for a flags type.
|
|||
|
|
Á $ÐE Ž Ž
|
|||
|
|
ÍÏ,íF Þ�Î ,ÚE þ �Î $æE ž�Î�Î LñE Ãî�Î�Î ¬�F �Î�ÎÅî �ÎlˆF ãï�Î�Î ¤�F �Î�Îåï �Îl£F ƒñ�Î�Î ¬¸F �Î�Î…ñ �Îl¿F ˜ �Î ”ÔF �Ι �ÎlØF Óé<ùF Ž ÍÏþ ¬’ô ¼’ê Ì’Ü à’Í õ’» �“¬ ¢“š º“‹ Ï“y ç“o ÷“b Óé` ÍÏL ¬’C ¼’: Ì’- à’ õ’ �“ ¢“ï º“à Ï“Î ç“Ä ÷“· Óéµ���� Œ¬G ü‡G A value with all bits unset.Á,²G Ž Ž �Î|çG ôÄG A value with all bits set.Á íG Ž Ž �Îœ‡I L‘I ‘ ‘ Ë´‡I ‘ Ë Ë ´ŸIL¬I ¶I ¯S ¼I ÎI , ½I ¾I ÌI
|
|||
|
|
, ¿I 8 uÁ ÀI & ÁI 8” ÂI $ ÄI , ÆI 8» ÇI & ÈI 8” ÉI $ ËI
|
|||
|
|
ÍI *ÐI ÓI S , ÝI ÞI ¦S 0 8 $ìI 8™ $ñI 8
|
|||
|
|
öI , úI 8×– ûI ýI ÛJ 8 ,�J 8Å ,•J & šJ , œJ 8×– �J ŸJ 7ì ¡J % ¢J 8 ,´J 8Ò ºJ & ½J , ¿J 8×– ÀJ ÂJ ÄJ , ÅJ 8×– ÆJ ÇJ 'ÈJ 8 MAXÁ ÊJ % ÍJ 8 $êJ 8™ $ïJ 8
|
|||
|
|
ôJ , øJ 8» ùJ ûJ ßK 8 ,�K 8Å ,“K & ˜K , šK 8» ›K �K 7ì ŸK % K 8 ,²K 8Ò ¸K & »K , ½K 8» ¾K ÀK ÂK , ÃK 8×– ÄK ÅK 'ÆK 8¼™ ÈK 8 ÌK , ÏK 8» ÐK % ÑK 8 $îK 8î DóK 8
|
|||
|
|
üK , €L 8×– �L ƒL ÐM 8 •L 8ý L˜L ¡L L 8’† ,¢L & §L ©L 8œ ªL (¯L 8ý 4²L ¸L 8 $¹L $ ½L 8¿ T¿L ÉL ËL ÂM
|
|||
|
|
áL , âL 8×– ãL äL 'åL 8 from_str_radixÁ tçL õL ÿL 8’† ,öL $ ûL 7 16Á ýL €M 8†
|
|||
|
|
<�M ˆM °M ‰M 8 ŠM ‹M 8¿ T�M '—M 8‘ „™M ©M ¯M 8’† ,ªM 8 $ßM 8î DäM 8
|
|||
|
|
íM , ñM 8» òM ôM ÁO 8 †N 8ý L‰N ’N žN 8’† ,“N & ˜N šN 8œ ›N ( N 8ý 4£N ©N 8 $ªN $ ®N 8¿ T°N ºN ¼N ³O
|
|||
|
|
ÒN , ÓN 8» ÔN ÕN 'ÖN 8Ú� tØN æN ðN 8’† ,çN $ ìN 7”ž îN ñN 8†
|
|||
|
|
<òN ùN ¡O úN 8 ûN üN 8¿ TþN 'ˆO 8‘ „ŠO šO O 8’† ,›O 8 $ÐO 8Ç DÕO 8
|
|||
|
|
ÞO , âO 8×– ãO åO ‰Q 8 ÷O 8Ö LúO ƒP 8æ „P & …P 8Í ‡P 'ŠP 8˜¹ ,ŒP ‘P ’P §P “P 8 $”P $ ˜P 8 šP 8æl 4žP & ¤P 8æ ¦P (©P 8Í ¬P '¯P 8ý 4±P ¸P ûP 8 writeÁ ,ÎP ÓP ÔP éP 8æl 4ÕP $ ÛP 7 {:x}Á 4ÝP $ ãP 8 $åP 8 $˜Q 8Ç D�Q 8
|
|||
|
|
¦Q , ªQ 8» «Q Q ÑR 8 ¿Q 8Ö LÂQ ËQ 8æ ÌQ & ÍQ 8Í ÏQ 'ÒQ 8˜¹ ,ÔQ ÙQ ÚQ ïQ ÛQ 8 $ÜQ $ àQ 8 âQ 8æl 4æQ & ìQ 8æ îQ (ñQ 8Í ôQ '÷Q 8ý 4ùQ €R ÃR 8¸¤ ,–R ›R œR ±R 8æl 4�R $ £R 7ï¤ 4¥R $ «R 8 $R 8 $àR 8Ü LåR 8
|
|||
|
|
ïR , óR 8» ôR öR ÷R 8 $…S 8Ü LŠS 8
|
|||
|
|
”S , ˜S 8×– ™S ›S œS
|
|||
|
|
§S ¬ûT üšT> ; A trait for referencing the `bitflags`-owned internal typeÁ üÙT! without exposing it publicly.Á \…U “ “ ËüûT¼ “ Ë Ë ”•”• ©â �Î ” ÔÃU ‘¸« LÓU °« È« ©â �Î • t§V å« ÌÃU ü—U' $ The type of the underlying storage.ÁLÈU “ “ l§V üãU? < The type of the internal field on the generated flags type.ÁD¬V “ “ üþV6¡ »V ¾V ÅV 8° 4¿V t¹V use the `Flags` trait insteadÁ üÈV5 DˆW Ù¬ – – ËüþV½ Ÿ�Î Ô’W q�Î ,¯W – Ë9 ®- ½®$ ËK ®? ½®6—˜—˜ ©â �Î — üþW! ÞK‘¯ ¬‰X ‘¯ßK �Î\’X ‰¯, ¢¯! ²¯ ©â �Î ˜ üƒY6 ÞK௠ü“Y% à¯ßK ½®�ÎÜœY د2 ñ¯' ‚° üþW ü»W> ; An iterator over enabled flags in an instance of the type.Á$ƒX Ù¬ – – üƒY5 ü¥XY V An iterator over the raw names and bits for enabled flags in an instance of the type.ÁLˆY Ù¬ – – ìÒY ‰ š š ÅŸ ×Y Ö ,ÚYó'›œ — ˜ LöY$ûY ™ ™ À't˜ZL�Z ™ ™ €(üÃZ/ ‰ ž ž ÅŸ ÈZ Ö ,ËZó' üš]$ ü÷Ze b A marker trait that signals that an implementation of `BitFlags` came from the `bitflags!` macro.Á Ý[Ë üá[c ` There's nothing stopping an end-user from implementing this trait, but we don't guarantee theirÁ üÅ\E B manual implementations won't break between non-breaking releases.Á¡ �] �] —] 8° 4‘] t‹] Ô¤] Ÿ Ÿ Ëüš]' Ÿ Ë Ë ÄÃ] LÒ] íÔò] Ÿ ¢ü\Ž^ “ £üê]0&(Œ¹;¡ ¬; ¯; ¶; 8° 4°; tª; LÁ; ³$‡= ¨ís Ÿ § ¢üu “ § £üÃ<5œË<Œã<CED±=„Ü=ƒk¬ù_ üùKï ê
|
|||
|
|
Generate a flags type.
|
|||
|
|
|
|||
|
|
# `struct` mode
|
|||
|
|
|
|||
|
|
A declaration that begins with `$vis struct` will generate a `struct` for a flags type, along with
|
|||
|
|
methods and trait implementations for it. The body of the declaration defines flags as constants,
|
|||
|
|
where each constant is a flags value of the generated flags type.
|
|||
|
|
|
|||
|
|
## Examples
|
|||
|
|
|
|||
|
|
Generate a flags type using `u8` as the bits type:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
struct Flags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 << 1;
|
|||
|
|
const C = 0b0000_0100;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Flags types are private by default and accept standard visibility modifiers. Flags themselves
|
|||
|
|
are always public:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
pub struct Flags: u8 {
|
|||
|
|
// Constants are always `pub`
|
|||
|
|
const A = 1;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Flags may refer to other flags using their [`Flags::bits`] value:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
struct Flags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 << 1;
|
|||
|
|
const AB = Flags::A.bits() | Flags::B.bits();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
A single `bitflags` invocation may include zero or more flags type declarations:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {}
|
|||
|
|
|
|||
|
|
bitflags! {
|
|||
|
|
struct Flags1: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
struct Flags2: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
# `impl` mode
|
|||
|
|
|
|||
|
|
A declaration that begins with `impl` will only generate methods and trait implementations for the
|
|||
|
|
`struct` defined outside of the `bitflags` macro.
|
|||
|
|
|
|||
|
|
The struct itself must be a newtype using the bits type as its field.
|
|||
|
|
|
|||
|
|
The syntax for `impl` mode is identical to `struct` mode besides the starting token.
|
|||
|
|
|
|||
|
|
## Examples
|
|||
|
|
|
|||
|
|
Implement flags methods and traits for a custom flags type using `u8` as its underlying bits type:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
struct Flags(u8);
|
|||
|
|
|
|||
|
|
bitflags! {
|
|||
|
|
impl Flags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 << 1;
|
|||
|
|
const C = 0b0000_0100;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
# Named and unnamed flags
|
|||
|
|
|
|||
|
|
Constants in the body of a declaration are flags. The identifier of the constant is the name of
|
|||
|
|
the flag. If the identifier is `_`, then the flag is unnamed. Unnamed flags don't appear in the
|
|||
|
|
generated API, but affect how bits are truncated.
|
|||
|
|
|
|||
|
|
## Examples
|
|||
|
|
|
|||
|
|
Adding an unnamed flag that makes all bits known:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
struct Flags: u8 {
|
|||
|
|
const A = 1;
|
|||
|
|
const B = 1 << 1;
|
|||
|
|
|
|||
|
|
const _ = !0;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Flags types may define multiple unnamed flags:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
# use bitflags::bitflags;
|
|||
|
|
bitflags! {
|
|||
|
|
struct Flags: u8 {
|
|||
|
|
const _ = 1;
|
|||
|
|
const _ = 1 << 1;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
Á &|é_ wu �` ñ} •` �b , Ÿ` ` ¯` + ¡` ¢` ®` , £` 8 outerÁ ,¤` & ©` 8«
|
|||
|
|
$ª`
|
|||
|
|
°` , º` 8¬ »` & ¾` 8¬ ¿` 8 4Ã` , Ê` 8¦ DË` & Ó` 8Û ,Ô` & Ù` , Û` 8™ Ü` & Ý` 8” Þ` á` èa , ï` ð` Ýa , ‚a ƒa a + „a …a Ÿa , †a 8‘ ,‡a & Œa 8Û ,�a , “a ”a �a , •a 8þ $–a & ša 8� ›a
|
|||
|
|
ža
|
|||
|
|
¡a 8 ,³a , ¹a 8á $ºa & ¾a 8� ¿a Âa , Äa 8˜ ,Åa & Êa 8ï $Ëa % Ïa
|
|||
|
|
Þa , óa ôa úa , õa 8 tÁ öa & ÷a 8� øa
|
|||
|
|
ûa *ƒb †b �s , üb 8 ,ýb '‚c 8à Ì„c �c Ÿc åc , c ®c ¸c + ¯c °c ·c , ±c 8‚Ì ,²c
|
|||
|
|
¹c , Çc 8¬ Èc 8 4Ìc , Óc 8¦ DÔc , »d 8 ,¼d 'Ád 8Š ìÃd àd âd ’f , ðd 8¦ Dñd & ùd , ûd 8™ üd þd ˆf , �e ‘e ùe
|
|||
|
|
, §e ¨e ¼e + ©e ªe »e , «e 8‘ ,¬e , ²e ³e ¹e , ´e 8þ $µe
|
|||
|
|
ºe
|
|||
|
|
½e 8 ,Óe , Ùe 8á $Úe ße , áe 8˜ ,âe % çe
|
|||
|
|
úe + �f žf •i 8è ,Ÿf ¤f ”i 8á L²f $ »f 8ÿ TÉf $ Óf 8 unused_doc_commentsÁ œáf $ ôf 8 unused_attributesÁ Œ‚g $ “g 8
|
|||
|
|
unused_mutÁ T¡g $ «g 8û t¹g $ Çg 8 non_upper_case_globalsÁ ´Õg $ ëg 8Æ 4ùg 'ÿg 8 assign_op_patternÁ Œ�h $ ’h 8Æ 4 h '¦h 8 indexing_slicingÁ „¨h $ ¸h 8Æ 4Æh 'Ìh 8 same_name_methodÁ „Îh $ Þh 8Æ 4ìh 'òh 8 iter_without_into_iterÁ ´ôh $ Ši 8 ,Ÿi 8 ¥i & ¦i ¨i ©i «i i Îr $ , Äj 8 ,Åj 'Êj 8¶ ÜÌj çj éj ¨k , ûj 8¬ üj 8 4€k 8 InternalBitFlagsÁ „‡k & —k , ™k 8™ šk , ·k 8 ,¸k '½k 8Ù Ä¿k ×k Ùk ·m 8ÅØ „ëk & ûk , ýk 8™ þk $ ÿk , �l 8¦ D‚l ‹l ©m , ¡l ¢l –m
|
|||
|
|
, ¼l ½l Ñl + ¾l ¿l Ðl , Àl 8‘ ,Ál , Çl Èl Îl , Él 8þ $Êl
|
|||
|
|
Ïl
|
|||
|
|
Òl 8 ,ìl , òl 8á $ól øl , úl 8˜ ,ûl % €m
|
|||
|
|
—m , ’n 8 ,“n '˜n 8ˆ Äšn ²n ´n ‰p 8ÅØ „Æn & Ön , Øn 8™ Ùn $ Ún , Ün 8¦ DÝn æn ûo , ün ýn èo , —o ˜o ¬o + ™o šo «o , ›o 8‘ ,œo , ¢o £o ©o , ¤o 8þ $¥o
|
|||
|
|
ªo
|
|||
|
|
o 8 ,Ço , Ío 8á $Îo % Òo
|
|||
|
|
éo , ˜p 8 ,™p 'žp 8� ô p ¾p Àp þp , Òp 8¦ DÓp & Ûp , Ýp 8™ Þp $ ßp 8ÅØ „áp , �q 8 ,Žq '“q 8è Ô•q ¯q ±q Ùq , Ãq 8¦ DÄq , èq 8 ,éq 'îq 8Å Üðq ‹r �r Är , Ÿr 8¦ D r & ¨r , ªr 8™ «r $ ¬r , ®r 8¦ D¯r % Ïr , Úr 8 ,Ûr 'àr 8Ð Dâr êr ìr ‰s , úr ûr þr , ür 8ÝÏ ýr
|
|||
|
|
ÿr % �s –s ÷t , s ¡s °s + ¢s £s ¯s , ¤s 8‚Ì ,¥s & ªs 8«
|
|||
|
|
$«s
|
|||
|
|
±s 8 $»s , Às 8¦ DÁs & És 8Û ,Ês & Ïs , Ñs 8™ Òs & Ós 8” Ôs ×s Þt , ås æs Ót , øs ùs –t + ús ûs •t , üs 8‘ ,ýs & ‚t 8Û ,ƒt , ‰t Št “t , ‹t 8þ $Œt & �t 8� ‘t
|
|||
|
|
”t
|
|||
|
|
—t 8 ,©t , ¯t 8á $°t & ´t 8� µt ¸t , ºt 8˜ ,»t & Àt 8ï $Át % Åt
|
|||
|
|
Ôt , ét êt ðt , ët 8ÝÏ ìt & ít 8� ît
|
|||
|
|
ñt *ùt üt à} , †u 8 ,‡u 'Œu 8Š ìŽu «u u Ýv , »u 8¦ D¼u & Äu , Æu 8™ Çu Éu Óv , Ûu Üu Äv
|
|||
|
|
, òu óu ‡v + ôu õu †v , öu 8‘ ,÷u , ýu þu „v , ÿu 8þ $€v
|
|||
|
|
…v
|
|||
|
|
ˆv 8 ,žv , ¤v 8á $¥v ªv , ¬v 8˜ ,v % ²v
|
|||
|
|
Åv + èv év ”y 8è ,êv ïv “y 8á Lýv $ †w 8ÿ T”w $ žw 8ÁÔ œ¬w $ ¿w 8æÔ ŒÍw $ Þw 8‰Õ Tìw $ öw 8û t„x $ ’x 8·Õ ´ x $ ¶x 8Æ 4Äx 'Êx 8ñÕ ŒÌx $ Ýx 8Æ 4ëx 'ñx 8Ž× ´óx $ ‰y 8 ,žy 8 ¤y & ¥y §y ¨y ªy ¬y Ÿ} , ºy 8 ,»y 'Ày 8§ ´Ây Øy Úy Ï{ , ìy íy ÷y + îy ïy öy , ðy 8‚Ì ,ñy
|
|||
|
|
øy , Šz 8¦ D‹z & “z , •z 8™ –z $ —z , ™z 8¦ Dšz £z Á{ , ¹z ºz ®{
|
|||
|
|
, Ôz Õz éz + Öz ×z èz , Øz 8‘ ,Ùz , ßz àz æz , áz 8þ $âz
|
|||
|
|
çz
|
|||
|
|
êz 8 ,„{ , Š{ 8á $‹{ �{ , ’{ 8˜ ,“{ % ˜{
|
|||
|
|
¯{ , Þ{ 8 ,ß{ 'ä{ 8è Ôæ{ €| ‚| ª| , ”| 8¦ D•| , ¹| 8 ,º| '¿| 8Å ÜÁ| Ü| Þ| •} , ð| 8¦ Dñ| & ù| , û| 8™ ü| $ ý| , ÿ| 8¦ D€} % } , «} 8 ,¬} '±} 8Ð D³} »} ½} Ú} , Ë} Ì} Ï} , Í} 8ÝÏ Î}
|
|||
|
|
Ð} % á} ç} è} *ê} í} î} % ï} äÖ üô}* ' Implement functions on bitflags types.Á Ÿ~Ë ü£~^ [ We need to be careful about adding new methods and trait implementations here because theyÁ ü‚4 1 could conflict with items added by the end-user.Á¡ É Ì Ó 8° 4Í tÇ &|· Úˆ ó ã° ù š‹ ( 8 paramsÁ 4‰� & �� , ‘� 8 $’� & –� 8Û ,—� $ œ� , ž� 8Ó $Ÿ� & £� 8Û ,¤� $ ©� , «� 8ÿ
|
|||
|
|
$¬� & °� 8Û ,±� $ ¶� , ¸� 8î ,¹� & ¾� 8Û ,¿� $ Ä� , Æ� 8˜ ,Ç� & Ì� 8Û ,Í� % Ò� , Ü� Ý� ì� + Þ� ß� ë� , à� 8‚Ì ,á� & æ� 8«
|
|||
|
|
$ç�
|
|||
|
|
í� , ÷� 8 PublicBitFlagsÁ tø� & †‚ 8Û ,‡‚ & Œ‚ , Ž‚ 8™ �‚ & �‚ 8” ‘‚ ”‚ ”‹ Œ 8 ¢‚ 8¤ ,¥‚ ª‚ «‚ , ‚ 8
|
|||
|
|
empty_bodyÁ T®‚ & ¸‚ 8ó ,¹‚ 8 Ë‚ 8à ΂ Ñ‚ Ò‚ , Ô‚ 8 all_bodyÁ DÕ‚ & Ý‚ 8ó ,Þ‚ 8 ð‚ 8Ó $ó‚ ÷‚ ý‚ ø‚ 8 $ù‚ , ÿ‚ 8 bits_bodyÁ L€ƒ & ‰ƒ 8ó ,Šƒ 8 œƒ 8Þ LŸƒ ¨ƒ ƒ 8Ó $©ƒ , ¯ƒ 8 from_bits_bodyÁ t°ƒ & ¾ƒ 8ó ,¿ƒ 8 у 8î ”Ôƒ æƒ ëƒ 8Ó $çƒ , íƒ 8 from_bits_truncate_bodyÁ ¼îƒ & …„ 8ó ,†„ 8 ˜„ 8‡ „›„ «„ °„ 8Ó $¬„ , ²„ 8 from_bits_retain_bodyÁ ¬³„ & È„ 8ó ,É„ 8 Û„ 8ž LÞ„ ç„ ì„ 8ÿ
|
|||
|
|
$è„ , î„ 8 from_name_bodyÁ tï„ & ý„ 8ó ,þ„ 8 �… 8ß D“… ›… ¡… œ… 8 $�… , £… 8
|
|||
|
|
is_empty_bodyÁ l¤… & ±… 8ó ,²… 8 Ä… 8î 4Ç… Í… Ó… Î… 8 $Ï… , Õ… 8 is_all_bodyÁ \Ö… & á… 8ó ,â… 8 ô… 8û T÷… �† Ž† ‚† 8 $ƒ† $ ‡† 8î ,‰† , �† 8 intersects_bodyÁ |‘† & † 8ó ,¡† 8 ³† 8Œ D¶† ¾† ˆ ¿† 8 $À† $ Ć 8î ,Ɔ , ͆ 8
|
|||
|
|
contains_bodyÁ lΆ & Û† 8ó ,܆ 8 î† 8ª 4ñ† ÷† ˆ‡ ø† 8 ù† 8 $ý† $ �‡ 8î ,ƒ‡ , Š‡ 8 insert_bodyÁ \‹‡ & –‡ 8ó ,—‡ 8 ©‡ 8· 4¬‡ ²‡ Ç ³‡ 8 ´‡ 8 $¸‡ $ ¼‡ 8î ,¾‡ , Ň 8 remove_bodyÁ \Ƈ & ч 8ó ,Ò‡ 8 ä‡ 8Ä 4ç‡ í‡ þ‡ î‡ 8 ï‡ 8 $ó‡ $ ÷‡ 8î ,ù‡ , €ˆ 8 toggle_bodyÁ \�ˆ & Œˆ 8ó ,�ˆ 8 Ÿˆ 8Ñ ¢ˆ ¥ˆ ½ˆ ¦ˆ 8 §ˆ 8 $«ˆ $ ¯ˆ 8î ,±ˆ $ ¶ˆ 8˜ ,¸ˆ , ¿ˆ 8 set_bodyÁ DÀˆ & Ȉ 8ó ,Ɉ 8 Ûˆ 8ç dÞˆ êˆ öˆ 8 $ëˆ $ ïˆ 8î ,ñˆ , øˆ 8 intersection_bodyÁ Œùˆ & Š‰ 8ó ,‹‰ 8 �‰ 8C , ‰ ¥‰ ±‰ 8 $¦‰ $ ª‰ 8î ,¬‰ , ³‰ 8
|
|||
|
|
union_bodyÁ T´‰ & ¾‰ 8ó ,¿‰ 8 щ 8€ TÔ‰ Þ‰ ê‰ 8 $߉ $ ㉠8î ,å‰ , ì‰ 8 difference_bodyÁ |í‰ & ü‰ 8ó ,ý‰ 8 �Š 8‘ ¤’Š ¦Š ²Š 8 $§Š $ «Š 8î ,Š , ´Š 8 symmetric_difference_bodyÁ ̵Š & Ί 8ó ,ÏŠ 8 አ8¬ TäŠ îŠ óŠ 8 $ïŠ , õŠ 8 complement_bodyÁ |öŠ & …‹ 8ó ,†‹ *œ‹ Ÿ‹ à° + ©‹ ª‹ Ú‹ 8è ,«‹ °‹ Ù‹ 8á L±‹ $ º‹ 8ÿ T¼‹ $ Æ‹ 8æÔ ŒÈ‹ , ä‹ å‹ ï‹ + æ‹ ç‹ î‹ , è‹ 8‚Ì ,é‹
|
|||
|
|
ð‹ 8 $ú‹ , ÿ‹ 8¸õ t€Œ �Œ Ú° • < ‡ìü�Œ* + ÔŒ ÕŒ ÜŒ 8þ 4ÖŒ 8 êŒ 8 ,îŒ 8 ôŒ 8¤ ,÷Œ üŒ ýŒ (ÿŒ 8 $‚� , —� 8Ôö T˜� < íìü°�. + ë� ì� ó� 8þ 4í� 8 �Ž 8 ,…Ž 8 ‹Ž 8à ŽŽ ‘Ž ’Ž (”Ž 8 $—Ž , ¬Ž 8¬÷ DŽ < óîüÃŽ" < Ë òŽ < ©ïü‚�C + Ò� Ó� Ú� 8þ 4Ô� 8 è� 8 ,ì� 8 ò� 8Ó $õ� ù� €� ú� , û� 8 $ü� (‚� , …� 8™ †� , ˜� 8•ø L™� < Åðô°� < Ë Û� < ÷ðüë�? + ·‘ ¸‘ ¿‘ 8þ 4¹‘ 8 Í‘ 8 ,Ñ‘ 8 ב 8Þ LÚ‘ ã‘ í‘ , ä‘ 8Ó $å‘ & é‘ , ë‘ 8™ ì‘ (ï‘ , ò‘ 8 ,ó‘ 'ø‘ 8Ž Lú‘ 'ƒ’ 8³ $…’ '‰’ 8ä 4‹’ '‘’ 8Ó 4“’ ™’ 8 $š’ ž’ , °’ 8øø t±’ < ‚òüÍ’: + ”“ •“ œ“ 8þ 4–“ 8 ª“ 8 ,®“ 8 ´“ 8î ”·“ É“ Ó“ , Ê“ 8Ó $Ë“ & Ï“ , Ñ“ 8™ Ò“ (Õ“ 8 $Ø“ , í“ 8àù ¼î“ < ƒóü“”& + Æ” Ç” Δ 8þ 4È” 8 Ü” 8 ,à” 8 æ” 8‡ „é” ù” ƒ• , ú” 8Ó $û” & ÿ” , �• 8™ ‚• (…• 8 $ˆ• , �• 8Ñú ¬ž• < ñóüÁ•F < Ë ”– < Ëôü¤–@ < ”õüñ–! + Ÿ— — §— 8þ 4¡— 8 µ— 8 ¹— 8ž L¼— Å— Ñ— , Æ— 8ÿ
|
|||
|
|
$Ç— & Ë— Í— 8œ Η (Ó— , Ö— 8 ,×— 'Ü— 8Ž LÞ— 'ç— 8³ $é— 'í— 8ä 4ï— 'õ— 8Ó 4÷— ý— 8 $þ— ‚˜ , ”˜ 8Àû t•˜ < Ÿüü±˜3 + ñ˜ ò˜ ù˜ 8þ 4ó˜ 8 ‡™ 8 ,‹™ 8 ‘™ 8ß D”™ œ™ £™ �™ , ž™ 8 $Ÿ™ (¥™ 8õ $¨™ , ½™ 8¯ü l¾™ < ®ýüÙ™7 + �š žš ¥š 8þ 4Ÿš 8 ³š 8 ,·š 8 ½š 8î 4Àš Æš Íš Çš , Èš 8 $Éš (Ïš 8õ $Òš , çš 8�ý \èš < Ãþü�›V + ä› å› ì› 8þ 4æ› 8 ú› 8 ,þ› 8 „œ 8û T‡œ ‘œ ¦œ ’œ , “œ 8 $”œ $ ˜œ , šœ 8î ,›œ & œ 8 $¢œ (¨œ 8õ $«œ , Àœ 8�þ |Áœ < ‰€üÞœV + Á� Â� É� 8þ 4Ã� 8 ×� 8 ,Û� 8 á� 8Œ Dä� ì� �ž í� , î� 8 $ï� $ ó� , õ� 8î ,ö� & û� 8 $ý� (ƒž 8õ $†ž , ›ž 8¡ÿ lœž < á‚ü·ž9 + ýž þž …Ÿ 8þ 4ÿž 8 “Ÿ 8 —Ÿ 8ª 4šŸ Ÿ ¹Ÿ ¡Ÿ 8 ¢Ÿ , ¦Ÿ 8 $§Ÿ $ «Ÿ , Ÿ 8î ,®Ÿ & ³Ÿ 8 $µŸ , ËŸ 8®€ \ÌŸ < O The intersection of a source flags value with the complement of a target flagsÁüåŸR < value (`&!`).ÁŒÄ < Ë â < ù„üò W < Ù…üÖ¡? + ¢¢ £¢ ª¢ 8þ 4¤¢ 8 ¸¢ 8 ¼¢ 8· 4¿¢ Å¢ Þ¢ Æ¢ 8 Ç¢ , Ë¢ 8 $Ì¢ $ Т , Ò¢ 8î ,Ó¢ & Ø¢ 8 $Ú¢ , ð¢ 8¹� \ñ¢ < ƒ‡üŠ£C + Ú£ Û£ ⣠8þ 4Ü£ 8 ð£ 8 ô£ 8Ä 4÷£ ý£ –¤ þ£ 8 ÿ£ , ƒ¤ 8 $„¤ $ ˆ¤ , Š¤ 8î ,‹¤ & �¤ 8 $’¤ , ¨¤ 8Ä‚ \©¤ < J Call `insert` when `value` is `true` or `remove` when `value` is `false`.Áü¤M + œ¥ �¥ ¤¥ 8þ 4ž¥ 8 ²¥ 8 ¶¥ 8Ñ ¹¥ ¼¥ 㥠½¥ 8 ¾¥ , Â¥ 8 $Ã¥ $ Ç¥ , É¥ 8î ,Ê¥ & Ï¥ 8 $Ñ¥ $ Õ¥ , ×¥ 8˜ ,Ø¥ & Ý¥ 8õ $ߥ , õ¥ 8ムDö¥ < —‹üŒ¦: + Ó¦ Ô¦ Û¦ 8þ 4Õ¦ + é¦ ê¦ ó¦ 8÷
|
|||
|
|
Dë¦ 8 �§ 8 ,…§ 8 ‹§ 8ç dŽ§ š§ ®§ , ›§ 8 $œ§ $ § , ¢§ 8î ,£§ & ¨§ 8 $ª§ (°§ 8 $³§ , ȧ 8Ø„ ŒÉ§ < á‚üè§9 + ®¨ ¯¨ ¶¨ 8þ 4°¨ + Ĩ Ũ Ψ 8÷
|
|||
|
|
Dƨ 8 ܨ 8 ,ਠ8 æ¨ 8C ,é¨ î¨ ‚© , ï¨ 8 $ð¨ $ ô¨ , ö¨ 8î ,÷¨ & ü¨ 8 $þ¨ („© 8 $‡© , œ© 8Õ… T�© < ’Ÿüµ©R < ”ª < Ë ²ª < ù„üªW < ®�ü¦«C + ö« ÷« þ« 8þ 4ø« + Œ¬ �¬ –¬ 8÷
|
|||
|
|
DŽ¬ 8 ¤¬ 8 ,¨¬ 8 ®¬ 8€ T±¬ »¬ Ϭ , ¼¬ 8 $½¬ $ Á¬ , ì 8î ,Ĭ & ɬ 8 $ˬ (Ѭ 8 $Ô¬ , é¬ 8̆ |ê¬ < ƒ‡ü‡C + × Ø ß 8þ 4Ù + í î ÷ 8÷
|
|||
|
|
Dï 8 …® 8 ,‰® 8 �® 8‘ ¤’® ¦® º® , §® 8 $¨® $ ¬® , ®® 8î ,¯® & ´® 8 $¶® (¼® 8 $¿® , Ô® 8ȇ ÌÕ® < ¢�üü®S + ܯ ݯ ä¯ 8þ 4Þ¯ + ò¯ ó¯ ü¯ 8÷
|
|||
|
|
Dô¯ 8 Š° 8 ,Ž° 8 ”° 8¬ T—° ¡° §° , ¢° 8 $£° (©° 8 $¬° , Á° 8ºˆ |° % á° Üû¾ üæ°K H A macro that matches flags values, similar to Rust's `match` statement.Á ²±Ë ü¶±c ` In a regular `match` statement, the syntax `Flag::A | Flag::B` is interpreted as an or-pattern,Á üš²o l instead of the bitwise-or of `Flag::A` and `Flag::B`. This can be surprising when combined with flags typesÁ üŠ³l i because `Flag::A | Flag::B` won't match the pattern `Flag::A | Flag::B`. This macro is an alternative toÁ ü÷³: 7 `match` for flags values that doesn't have this issue.Á ²´Ë d¶´ # SyntaxÁ Ã´Ë lÇ´
|
|||
|
|
```ignoreÁ üÕ´! bitflags_match!(expression, {Á ä÷´ pattern1 => result1,Á 䔵 pattern2 => result2,Á T±µ ..Á ä¼µ _ => default_result,Á 4Ùµ })Á <ൠ```Á èµË üìµ^ [ The final `_ => default_result` arm is required, otherwise the macro will fail to compile.Á Ë¶Ë t϶ # ExamplesÁ Þ¶Ë \ⶠ```rustÁ üî¶- * use bitflags::{bitflags, bitflags_match};Á œ·Ë | · bitflags! {Á ä°· #[derive(PartialEq)]Á ÔÍ· struct Flags: u8 {Á ìè· const A = 1 << 0;Á 솸 const B = 1 << 1;Á 줸 const C = 1 << 2;Á L¸ }Á ,̸ }Á Ò¸Ë üÖ¸$ ! let flags = Flags::A | Flags::B;Á û¸Ë üÿ¸$ ! // Prints `the value is A and B`Á 䤹 bitflags_match!(flags, {Á üÁ¹@ = Flags::A | Flags::B => println!("the value is A and B"),Á ü‚º2 / _ => println!("the value is not A and B"),Á <µº });Á ½ºË üÁº" // Prints `the value is not A`Á ääºøº ü�»/ , Flags::A => println!("the value is A"),Á ü±», ) _ => println!("the value is not A"),Á <Þ»£¼ <滈¶ î»Ë ”ò» # How it worksÁ …¼Ë ü‰¼h e The macro expands to a series of `if` statements, **checking equality** between the input expressionÁ üò¼e b and each pattern. This allows for correct matching of bitflag combinations, which is not possibleÁ üؽL I with a regular match expression due to the way bitflags are implemented.Á ¥¾Ë ü©¾A > Patterns are evaluated in the order they appear in the macro.Á &|ë¾ ^° —¿ ¯Á �¿ È¿ , ž¿ 8 operationÁ LŸ¿ & ¨¿ 8ï $©¿ $ ¿ ¯¿ Ç¿ , ¹¿ º¿ À¿ , »¿ 8ÝÏ ¼¿ & ½¿ 8� ¾¿
|
|||
|
|
Á¿ *Ê¿ Í¿ ¬Á ×À ¤Á ØÀ ÛÀ £Á , éÀ 8 ,êÀ 'ïÀ 8Š „ñÀ �Á ‚Á ™Á , ƒÁ 8êÁ L„Á $ �Á �Á ˜Á , ‘Á ’Á •Á , “Á 8ÝÏ ”Á
|
|||
|
|
–Á ¥Á ¦Á % Á ì÷Á ü²Á% " Expand the `bitflags_match` macroÁ¡ êÁ íÁ ôÁ 8° 4îÁ tèÁ &|ØÁ o° •Â àÉ Ò •Ã , Ó 8êÁ LÔ & Ý 8ï $Þ $ â ä ”Ã
|
|||
|
|
, æ 8 patternÁ <ç & î 8ï $ï *ô ÷ †Ã , ù ú ƒÃ , û 8 bodyÁ $ü & €Ã 8� �Ã
|
|||
|
|
„à $ ˆÃ , ŠÃ ‹Ã ‘à , ŒÃ 8ÝÏ �à & ŽÃ 8� �à ’à *—à šÃ ôà , ¤Ã 8 ,¥Ã 'ªÃ 8Š „¬Ã ¼Ã ½Ã îà , ¾Ã 8êÁ L¿Ã $ Èà Êà íà , Ìà 8²Æ <Íà *Õà Øà äà , Úà Ûà áà , Üà 8�Ç $ÝÃ
|
|||
|
|
âà , æà çà êà , èà 8ÝÏ éà ëà % õà ©Ä êÄ , ªÄ 8êÁ L«Ä & ´Ä 8ï $µÄ $ ¹Ä »Ä éÄ , ½Ä 8²Æ <¾Ä & ÅÄ 8ï $ÆÄ *ËÄ ÎÄ ÝÄ , ÐÄ ÑÄ ÚÄ , ÒÄ 8�Ç $ÓÄ & ×Ä 8� ØÄ
|
|||
|
|
ÛÄ , ßÄ àÄ æÄ , áÄ 8ÝÏ âÄ & ãÄ 8� äÄ çÄ *ìÄ ïÄ ÈÆ ùÄ ÂÆ
|
|||
|
|
8 ‡Å , ŠÅ 8êÁ L‹Å •Å , ˜Å 8²Æ <™Å ¡Å ùÅ 8 4³Å ºÅ êÅ , ÐÅ ÑÅ ×Å , ÒÅ 8�Ç $ÓÅ
|
|||
|
|
ØÅ % ëÅ , ˆÆ 8 ,‰Æ 'ŽÆ 8Š „�Æ Æ ¡Æ ¸Æ , ¢Æ 8êÁ L£Æ $ ¬Æ ®Æ ·Æ , °Æ ±Æ ´Æ , ²Æ 8ÝÏ ³Æ µÆ % ÉÆ ÿÆ ¼Ç , €Ç 8êÁ L�Ç & ŠÇ 8ï $‹Ç $ �Ç ‘Ç »Ç
|
|||
|
|
, “Ç 8²Æ <”Ç & ›Ç 8ï $œÇ *¡Ç , ¤Ç 8�Ç $¥Ç & ©Ç 8ï $ªÇ $ ¯Ç , ±Ç ²Ç ¸Ç , ³Ç 8ÝÏ ´Ç & µÇ 8� ¶Ç ¹Ç *¾Ç ÁÇ îÈ ËÇ èÈ
|
|||
|
|
8 ÙÇ , ÜÇ 8êÁ LÝÇ çÇ , êÇ 8²Æ <ëÇ óÇ ŸÈ 8 4…È , ŒÈ 8�Ç $�È % ‘È , ®È 8 ,¯È '´È 8Š „¶È ÆÈ ÇÈ ÞÈ , ÈÈ 8êÁ LÉÈ $ ÒÈ ÔÈ ÝÈ , ÖÈ ×È ÚÈ , ØÈ 8ÝÏ ÙÈ ÛÈ % ïÈ ”É ÂÉ , •É 8êÁ L–É & ŸÉ 8ï $ É $ ¤É ¦É ÁÉ 8 ¨É *ªÉ , É 8> <®É & µÉ 8ï $¶É , »É ¼É ¾É $ ½É - ¿É *ÄÉ ÇÉ ÞÉ , ÑÉ 8> <ÒÉ üäÍ' üãÉR O A macro that processed the input to `bitflags!` and shuffles attributes aroundÁ ü¶Ê6 3 based on whether or not they're "expression-safe".Á íÊË üñÊ> ; This macro is a token-tree muncher that works on 2 levels:Á °ËË ü´ËV S For each attribute, we explicitly match on its identifier, like `cfg` to determineÁ ü‹Ì; 8 whether or not it should be considered expression-safe.Á ÇÌË üËÌT Q If you find yourself with an attribute that should be considered expression-safeÁ ü Í$ ! and isn't, it can be added here.Á¡ ×Í ÚÍ áÍ 8° 4ÛÍ tÕÍ &|ÅÍ €° ŒÎ ›á ŽÏ ÑÏ , ˜Ï ™Ï ¶Ï + šÏ ›Ï µÏ , œÏ 8‘ ,�Ï & ¢Ï 8Û ,£Ï , ©Ï ªÏ ³Ï , «Ï 8þ $¬Ï & °Ï 8� ±Ï
|
|||
|
|
´Ï
|
|||
|
|
·Ï ÁÏ ËÏ , ÃÏ 8¿ ÄÏ & ÅÏ 8ï $ÆÏ *ÓÏ ÖÏ ™Ò , àÏ 8 ,áÏ 'æÏ 8¡ ÔèÏ ‚Ð „Ð “Ò 8ï $’Ð & –Ð ˜Ð �Ð , šÐ 8¿ ›Ð $ žÐ 8 attrsÁ ,¬Ð & ±Ð ³Ð ˆÒ 8 unprocessedÁ \òÐ & ýÐ ÿÐ —Ñ , €Ñ �Ñ •Ñ + ‚Ñ ƒÑ ”Ñ , „Ñ 8‘ ,…Ñ , ‹Ñ ŒÑ ’Ñ , �Ñ 8þ $ŽÑ
|
|||
|
|
“Ñ
|
|||
|
|
–Ñ $ ˜Ñ 8 processedÁ LíÑ & öÑ øÑ ùÑ $ úÑ $ ‰Ò % šÒ �Ô šÖ 8ï $§Ô & «Ô Ô ·Ô , ¯Ô 8¿ °Ô & ±Ô 8ï $²Ô $ ¸Ô 8ÉÝ ,ÆÔ & ËÔ ÍÔ “Ö 8ñÝ \ÛÔ & æÔ èÔ áÕ + žÕ ŸÕ °Õ 8¢ Õ , ¤Õ ¥Õ ®Õ , ¦Õ 8þ $§Õ & «Õ 8� ¬Õ
|
|||
|
|
¯Õ , ÂÕ ÃÕ ÒÕ , ÄÕ 8
|
|||
|
|
attrs_restÁ TÅÕ & ÏÕ 8� ÐÕ
|
|||
|
|
ÓÕ $ âÕ 8¤ß LðÕ & ùÕ ûÕ ˆÖ , üÕ ýÕ †Ö , þÕ 8ï $ÿÕ & ƒÖ 8� „Ö
|
|||
|
|
‡Ö $ ‰Ö $ ”Ö *œÖ ŸÖ ŠÙ , ©Ö 8 ,ªÖ '¯Ö 8¡ Ô±Ö ËÖ ÍÖ „Ù 8ï $ÛÖ & ßÖ áÖ æÖ , ãÖ 8¿ äÖ $ çÖ 8ÉÝ ,õÖ & úÖ üÖ ùØ 8ñÝ \Ž× & ™× ›× Ñ× , ±× ²× ¾× , ³× 8›â T´×
|
|||
|
|
¿× $ Ò× 8¤ß Lä× & í× ï× êØ , …Ø †Ø ŒØ , ‡Ø 8ï $ˆØ
|
|||
|
|
�Ø + ÉØ ÊØ ØØ 8¢ ËØ , ÏØ ÐØ ÖØ , ÑØ 8þ $ÒØ
|
|||
|
|
×Ø $ ëØ $ úØ % ‹Ù ŽÚ —Ü 8ï $˜Ú & œÚ žÚ ¨Ú , Ú 8¿ ¡Ú & ¢Ú 8ï $£Ú $ ©Ú 8ÉÝ ,·Ú & ¼Ú ¾Ú �Ü 8ñÝ \ÌÚ & ×Ú ÙÚ ÞÛ + ’Û “Û Û , ”Û 8î ,•Û & šÛ 8Û ,›Û , ¡Û ¢Û «Û , £Û 8þ $¤Û & ¨Û 8� ©Û
|
|||
|
|
¬Û , ¿Û ÀÛ ÏÛ , ÁÛ 8›â TÂÛ & ÌÛ 8� ÍÛ
|
|||
|
|
ÐÛ $ ßÛ 8¤ß LíÛ & öÛ øÛ …Ü , ùÛ úÛ ƒÜ , ûÛ 8ï $üÛ & €Ü 8� �Ü
|
|||
|
|
„Ü $ †Ü $ ‘Ü *™Ü œÜ íÞ , ¦Ü 8 ,§Ü '¬Ü 8¡ 暴 ÈÜ ÊÜ çÞ 8ï $ØÜ & ÜÜ ÞÜ ãÜ , àÜ 8¿ áÜ $ äÜ 8ÉÝ ,öÜ & ûÜ ýÜ ÜÞ 8ñÝ \�Ý & šÝ œÝ ÒÝ , ²Ý ³Ý ¿Ý , ´Ý 8›â TµÝ
|