2253 lines
695 KiB
Plaintext
2253 lines
695 KiB
Plaintext
|
rust
|
|||
|
|
|
|||
|
|
Ù
|
|||
|
|
#rustc 1.96.0 (ac68faa20 2026-05-25)ÁÀ뉊 ]!ÜÛê(¹Þ—šên -5be7b69c3ff7b5b8Á íàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤²XctÔ'ÐÓ©z¨É½Ó -a4945860e1c53b00Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ–�òÖÀH•‘P IÓHã#£ -055f30b747f859b6Á rustc_std_workspace_coreÁCçß^ò½èÝ$Çÿ+Cé -c4878ee60b2242c9Á ŸÃï+Ñ]ŠqB<ÏïW# -8dd1dd90e70d0b6aÁ miniz_oxideÁ€š»J(P>àö÷g\K -1eb618da2918ab7fÁ adler2ÁÆ;+Þ®5¥ÌýÝ°¦ÛLˆ -f7919172d268e069Á hashbrownÁPäV9ÒÆèÜ�"ÊÖVŽ\ -0fc2184a5da6723aÁ rustc_std_workspace_allocÁs&ØòØy¯s•bæ!‰ýŠ -97e4bf30be240674Á
|
|||
|
|
std_detectÁhŠBîÙºÌI®Ë�Å�š -9dbbf8346ba7ac8bÁ rustc_demangleÁûë9´Ç×@Œ�’ùXFº -f33013f239bf9f14Á cfg_ifÁÜLh�ž§Œaã¯>� -0a71c8f33a838301Á addr2lineÁ׎Þ!]8V$É@@T· -e618e6be60e87ba2Á gimliÁ¸
|
|||
|
|
°µ~Î1‹Ñt ðÁ€w -1f7768a68858f670Á objectÁ
|
|||
|
|
áPÃ?À¶¼QHJ¥� -914cd6a4dbe590d1Á memchrÁ›º«8Ór2Ù $¨ûib‚ -cf21ca6f2bb15dcdÁë
|
|||
|
|
‹ás «LÖ€îâƒ×ɯŒ -ee6f3747e38367f0Á pin_project_liteÁ·x¼+Ä`·á¨›�t—¸Íœ -2dc344ecc91b59efÁ futures_sinkÁL 1Tš½‰¤
|
|||
|
|
¾
|
|||
|
|
Èþ. -14e3b8a05e30b9eeÁ tokioÁJ;Ì3‹<þÝñŠ7_�ú -081d57d1ceb823d6Á parking_lotÁâ°r4¨6ª(ü²Hd©n¼ -21962aa896c8619bÁ lock_apiÁEcÓŽ/ÅS}sw‡A$P -0e8055cd433fa267Á
|
|||
|
|
scopeguardÁ’‰‘p ÒÞa¢ßöéqÓB -29f0bdb2ea82739eÁ parking_lot_coreÁ’Ý%Ž=Eq^U4FOV)àŸ -e1ee0517e8b9a4bfÁ smallvecÁ[“S‰«2ûÓàÁ3™ËºS -fa382cf08413422fÁ serdeÁFV æ¸Û•IÄÀz Í -9c8ce3cf08540cc3Á serde_deriveÁ,w|êñ]ù¿¥C£ð -975c43f96d83014eÁ
|
|||
|
|
serde_coreÁ²€Ãb˜ cÐòÅ�¾ÇÇ
|
|||
|
|
-7a42419d8e43b208Á ®f©¾/ô)c§{õa“â‘ -a3906971a93fd1b8Á –æ\‹±Ôcd�-»ùÀTƒ -f86f80b348d33b13Á mioÁGù�j0ðÔ·â"FÆ#0Q -3545320490828222Á bytesÁ�`²['3_ ²µÆ=üå¥ -d4f44708ed5da7b6Á tokio_macrosÁóÁm¹^E�¼>ŽCê
|
|||
|
|
z3 -074a4ab5bbda1a72Á socket2ÁsT›¸n>~R�Ê1G/R -c161f09f0083d1e0Á signal_hook_registryÁœ¥¿’g›´·D V<{Y<< -b3ea108dcb9d0adeÁ errnoÁÍ\Ý| #{°zŽ¡p&a” -464950f23d45b34dÁ futures_coreÁÆöc$Ž³–º¾v¸dK -ac1e9cdb826f83c0Á K Ê ‚ $œ ¤,Ï ‚ ¥TÖ ‚ $& taskÁ$æ» rtÁtÍ testsÁ,ö‚ $ë¬ú,“/‚ $ü. udpÁ Ê» netÁxFã µ Û»µ compatÁ4ý»×�G˜� read_arcÁDò» io-utilÁ˜Q¬� read_exact_arcÁt˜»‰&(� sync_bridgeÁ\±»‰FH� SyncIoBridgeÁdÝ»‰gi contextÁ<»»îpRŠ timeÁ$…»�€S× è poll_proceedÁd€»îpúŠ À â cfg_codecÁ
|
|||
|
|
cfg_compatÁ cfg_netÁ cfg_ioÁ cfg_rtÁ
|
|||
|
|
cfg_not_rtÁ cfg_timeÁ loomÁ ç ç cancellation_tokenÁ £ disarmÁ ã guard_refÁ 'aÁ ® ã tree_nodeÁ TreeNodeÁ % innerÁ % wakerÁ (æ ( notifiedÁ InnerÁ + parentÁ +
|
|||
|
|
parent_idxÁ + childrenÁ + is_cancelledÁ + num_handlesÁ “
|
|||
|
|
child_nodeÁ disconnect_childrenÁ with_locked_node_and_parentÁ 4— 4 RetÁ 4 move_children_to_parentÁ remove_childÁ increase_handle_refcountÁ decrease_handle_refcountÁ ; cancelÁ CancellationTokenÁ H¨ L× Nƒ Pã R> Tæ T child_tokenÁ T” T“ T cancelledÁ T cancelled_ownedÁ T
|
|||
|
|
drop_guardÁ T drop_guard_refÁ T run_until_cancelledÁ ]— ] ] T run_until_cancelled_ownedÁ a— a a eÞ e× hÞ h° hŠ l×
|
|||
|
|
næ n
|
|||
|
|
new_futureÁ q° qŠ tÞ t— tæ
|
|||
|
|
xÞ x— x° xŠ }— }° }Š �— �æ mpscÁ � ��������� �
|
|||
|
|
� ™¥ ™
|
|||
|
|
into_innerÁ �œ¥ œ× �Ÿ¥ � make_acquire_futureÁ ¡¥ ¡ ¡ ¤ � InnerFutureÁ ¦Þ ¦¥ �©¥ © emptyÁ « �¥ æ Š setÁ �²¥ ²æ ²
|
|||
|
|
take_stateÁ ² poll_reserveÁ ² send_itemÁ ² is_closedÁ ² get_refÁ ² closeÁ ²
|
|||
|
|
abort_sendÁ �¼¥ ¼ƒ �¿¥ ¿ ErrorÁ ¿
|
|||
|
|
poll_readyÁ ¿
|
|||
|
|
poll_flushÁ ¿
|
|||
|
|
start_sendÁ ¿
|
|||
|
|
poll_closeÁ
|
|||
|
|
poll_semaphoreÁ É ÉÉÉÉÉÉÉÉÉ É
|
|||
|
|
É É É
|
|||
|
|
É
|
|||
|
|
PollSemaphoreÁ Ø semaphoreÁ Ø
|
|||
|
|
permit_futÁ É Ûæ Ûä Û clone_innerÁ Û¨ Û poll_acquireÁ Û poll_acquire_manyÁ Û available_permitsÁ Û add_permitsÁ Éä› ä poll_nextÁ Éçƒ Éé× ÉëÉ reusable_boxÁ î îîîîîîîîî î
|
|||
|
|
î î î ReusableBoxFutureÁ üÞ ü¥ ü boxedÁ î €Þ €¥ €æ ƒ— €í …— € try_setÁ ‡— ‡ real_try_setÁ ‰Þ ‰— ‰ € get_pinÁ €Š î�¥ �° �Š î“¥ î•¥ •× î
|
|||
|
|
reuse_pin_boxÁ ˜¥ ˜¦ ˜ ˜— ˜ î
|
|||
|
|
CallOnDropÁ ž ž— ž± î¢ ¢— ¢æ ¢Ñ î§ §— §ã
|
|||
|
|
eitherÁ ¬ ¬¬¬¬¬¬¬¬¬ ¬
|
|||
|
|
¬ ¬ ¬
|
|||
|
|
¬
|
|||
|
|
delegate_callÁ ¬ ¼� ¼£ ¼ ¼° ¼Š ¬Â� £  poll_readÁ ¬Æ� Æ£ Æ
|
|||
|
|
poll_fill_bufÁ Æ consumeÁ ¬Ë� Ë£ Ë
|
|||
|
|
start_seekÁ Ë
|
|||
|
|
poll_completeÁ ¬Ð� У Ð
|
|||
|
|
poll_writeÁ ÐÄ Ð
|
|||
|
|
poll_shutdownÁ Ð poll_write_vectoredÁ Ð is_write_vectoredÁ ¬Ø� Ø£ Ø› د# ¬Ý� Ý£ Ý› Ý¥ Ý¥ ݲ ÝÖ ÝÄ Ýè utilÁ èé é éééééé
|
|||
|
|
MaybeDanglingÁ ð
|
|||
|
|
ð¥ ðˆ é ô¥ ôã é÷¥ ÷æ éú— ú° úŠ ý è poll_bufÁ ÿ ÿÿÿÿÿÿÿÿÿ ÿ
|
|||
|
|
ÿ ÿ ÿ
|
|||
|
|
ÿÿ
|
|||
|
|
poll_read_bufÁ �¥ �“ ÿ poll_write_bufÁ ’¥ ’“ ’ MAX_BUFSÁ ’ è èèè futureÁ › with_cancellation_tokenÁ œ œœœœœœœœœ œ
|
|||
|
|
œ ¨Þ ¨— ¨æ « œÞ — ° Š œ²— ²æ ´ œ¶— ¶° ¶Š › ››››› FutureExtÁ ¿‹/ ¿ with_cancellation_token_ownedÁ › Â¥ cfg_io_utilÁ tracingÁ Å traceÁ codecÁ Ç bytes_codecÁ È ÈÈÈÈÈÈÈ Ðæ ÈÒ› Ò¥ Ò decodeÁ ÈÖ¥ Ö encodeÁ ÈÙ¥ Ùï2 Ç Ç decoderÁ Ý ÝÝÝÝÝÝ DecoderÁ ä› ä¥ äÔ2 ä
|
|||
|
|
decode_eofÁ ä framedÁ é¥ ÇÇ encoderÁ ì ìì EncoderÁ ï› ï¥ ïï2 ÇÇ framed_implÁ ô ôôôôôôôôô ô
|
|||
|
|
ô ô ô
|
|||
|
|
ôôôôô INITIAL_CAPACITYÁ ô
|
|||
|
|
WriteFrameÁ ˆ bufferÁ ˆ backpressure_boundaryÁ ô ‹> ô�> ô�÷ ô‘÷ ô“ borrowÁ ô•
|
|||
|
|
borrow_mutÁ ô—Ö6 ô™é6 ô›¥ ›¦ ›£ ›› ›¯# ô ¥¥ ¥š ¥¦ ¥¨ ¥¥ ¥² ¥Ö ¥Ä ¥è ÇÇÇÇÇÇý3 µ µµµµµµµµµ µ
|
|||
|
|
µ µ µ
|
|||
|
|
µµµµµµµ Ê¥ ʦ Êæ Ê
|
|||
|
|
with_capacityÁ Ê
|
|||
|
|
from_partsÁ ÊÕ Ê get_mutÁ Ê get_pin_mutÁ Êï1 Ê codec_mutÁ Ê map_codecÁ Õ” Õ— Ê
|
|||
|
|
codec_pin_mutÁ Ê read_bufferÁ Ê read_buffer_mutÁ Ê write_bufferÁ Ê write_buffer_mutÁ Ê‚6 Ê set_backpressure_boundaryÁ ʨ Ê
|
|||
|
|
into_partsÁ µá¥ ᦠᛠá¯# µæ¥ æš æ¦ æ¥ æ² æÖ æÄ æè µï¥ ï¦ ï× µó¥ ó¦ óæ öš ÇÇ Ç
|
|||
|
|
Ç framed_readÁ û ûûûûûûûûû û
|
|||
|
|
û û û
|
|||
|
|
ûû ‹¥ ‹• ‹æ ‹Ê9 ‹Õ ‹ù9 ‹ˆ: ‹¨ ‹—3 ‹ decoder_mutÁ ‹ map_decoderÁ –” –— ‹ decoder_pin_mutÁ ‹ê: ‹ý: ‹ñ; û�¥ �• �› �¯# û¢¥ ¢š ¢• ¢¥ ¢² ¢Ö ¢Ä ¢è û«¥ «• «× Ç Ç framed_writeÁ ° °°°°°°°°° °
|
|||
|
|
° ° °
|
|||
|
|
°°° Á¥ Á– Áæ ÁÊ9 ÁÕ Áù9 Áˆ: Á¨ Á˜4 Á encoder_mutÁ Á map_encoderÁ Ì” Ì— Á encoder_pin_mutÁ Á”; Á¨; Á‚6 ÁÈ; Áñ; °Õ¥ Õš Õ– Õ¥ Õ² ÕÖ ÕÄ Õè °Þ¥ Þ• Þ› Þ¯# °ã¥ 㦠ã× Ç Ç length_delimitedÁ è èèèèèèèèè è
|
|||
|
|
è è è
|
|||
|
|
èèèèèèèèè LengthDelimitedCodecErrorÁ ÿ _privÁ è �æ � builderÁ � max_frame_lengthÁ � set_max_frame_lengthÁ � decode_headÁ � decode_dataÁ 舛 ˆ¥ ˆÔ2 茥 Œï2 Ž è�> èÍE ’ LengthFieldTypeÁ ’ ’’’’è™æ ™
|
|||
|
|
big_endianÁ ™
|
|||
|
|
little_endianÁ ™
|
|||
|
|
native_endianÁ ™ÜE ™ length_field_typeÁ Ÿ¥ ™ length_field_lengthÁ ™ length_field_offsetÁ ™ length_adjustmentÁ ™ num_skipÁ ™ new_codecÁ ™ new_readÁ ¦¥ ™ new_writeÁ ¨¥ ™
|
|||
|
|
new_framedÁ ª¥ ™ num_head_bytesÁ ™ get_num_skipÁ ™ adjust_max_frame_lenÁ è¯> è±× è³× èÇ
|
|||
|
|
ÇÇÇ lines_codecÁ ¹ ¹¹¹¹¹¹¹¹¹ ¹
|
|||
|
|
¹ Åæ Å new_with_max_lengthÁ Å
|
|||
|
|
max_lengthÁ ¹ utf8Á É ¹ without_carriage_returnÁ ¹Ì› Ì¥ ÌÔ2 Ï Ìë3 ¹Ò¥ Ò¥ Òï2 ¹Ö> ¹Ø× ¹Ú÷ ¹ÇÇÇÇ any_delimiter_codecÁ à ààààààààà à
|
|||
|
|
à à DEFAULT_SEEK_DELIMITERSÁ à DEFAULT_SEQUENCE_WRITERÁ à ïæ ïµK ïÐK àó› ó¥ óÔ2 ö óë3 àù¥ ù¥ ùï2 àý> àÿ× à�÷ àÇÇÇÈ
|
|||
|
|
BytesCodecÁ ‡
|
|||
|
|
‡ˆ ÈÈÈŒƒ ÈŽ× È�Ö È È
|
|||
|
|
“� È •‹ È —ï
|
|||
|
|
È
|
|||
|
|
™§ šù Èœ> ô ReadFrameÁ ž eofÁ ž is_readableÁ žô5 ž has_erroredÁ ô
|
|||
|
|
£× ô RWFramesÁ ¥ readÁ ¥ writeÁ ô ¨> µ FramedPartsÁ ª¥ ª¦ ª ioÁ ªï1 ª read_bufÁ ª write_bufÁ ª³E µ²¥ ²¦ ²× è BuilderÁ ¶
|
|||
|
|
max_frame_lenÁ ¶ length_field_lenÁ ¶¾H ¶ÙH ¶òH ¶ length_field_is_big_endianÁ è ½× è
|
|||
|
|
è Àƒ è è LengthDelimitedCodecÁ ÃÍE ú è
|
|||
|
|
Æ× èȃ è DecodeStateÁ Ê HeadÁ Ë
|
|||
|
|
Ê DataÁ Í
|
|||
|
|
͈ èÐ× èèÓƒ è¹
|
|||
|
|
LinesCodecÁ Ö
|
|||
|
|
next_indexÁ ÖÐK Ö
|
|||
|
|
is_discardingÁ ¹Úƒ ¹Ü× ¹ ÞÖ ¹
|
|||
|
|
¹ á� ¹ ã‹ ¹
|
|||
|
|
åï
|
|||
|
|
¹ç§ èù ¹ LinesCodecErrorÁ ê MaxLineLengthExceededÁ ë
|
|||
|
|
ê IoÁ í
|
|||
|
|
íˆ ¹ð× à AnyDelimiterCodecÁ ò½U òÐK ò×U ò seek_delimitersÁ ò sequence_writerÁ àøƒ àú× à üÖ à
|
|||
|
|
à ÿ� à �‹ à
|
|||
|
|
ĕ
|
|||
|
|
à…§ †ù à AnyDelimiterCodecErrorÁ ˆ MaxChunkLengthExceededÁ ‰
|
|||
|
|
ˆ�W ‹
|
|||
|
|
‹ˆ àŽ× ’R �
|
|||
|
|
copy_to_bytesÁ ‘ ‘‘‘‘‘‘‘‘ š¤ šæ šÕ šù9 š¨ ‘ Þ ¤ ¥ ² Ö Ä è ‘¨¤ ¨› ¨¯# � inspectÁ ¬ ¬¬¬¬¬¬¬¬¬ ¬
|
|||
|
|
¬ ¬ ¬ º£ º— ºæ º¨ ¬¿£ ¿— ¿”) ¬Ã£ × ï* ÃÄ ÃÉ* ÃÞ* Ãù* ¬Ë¨ Ë— Ëæ ˨ ¬Ð¨ З Я* ÐÄ ÐÉ* ÐÞ* Ðù* ¬Ø¨ Ø— Ø”) �¤R Ü ÜÜÜÜÜÜÜܤR å£ å“ å å é ReadBufFnÁ ê
|
|||
|
|
êÞ ê£ ê“ êˆ ê‰ é ñÞ ñ£ ñ“ ñ° ñŠ �
|
|||
|
|
reader_streamÁ ÷ ÷÷÷÷÷÷÷÷÷ ÷ DEFAULT_CAPACITYÁ ÷ ƒ £ ƒ æ ƒ Ê9 ÷‡ £ ‡ › ‡ ¯# Š � simplexÁ Œ Œ Œ Œ Œ Œ Œ Œ Œ Œ Œ
|
|||
|
|
Œ Œ Œ
|
|||
|
|
Œ Œ Œ Œ Œ Œ IoResultÁ ¥ Œ CLOSED_ERROR_MSGÁ Œ £ Ê9 £ register_receiver_wakerÁ £ register_sender_wakerÁ £ take_receiver_wakerÁ £ take_sender_wakerÁ £ Ä £ close_receiverÁ £ close_senderÁ Œ ¬ ã Œ ® ”) Œ ° ã Œ ² ¯* ² Ä ² É* ² ù* ² Þ* Œ æ � sink_writerÁ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹
|
|||
|
|
¹ ¹ Æ ¤ Æ æ Æ Õ Æ ù9 Æ ¨ ¹ Ì ¤ Ì – Ì Þ Ì ¯* Ì Ä Ì É* ¹ Ó ¤ Ó › Ó ¯# ¹ × ¤ × ”) �
|
|||
|
|
stream_readerÁ Ú Ú Ú Ú Ú Ú Ú Ú Ú Ú Ú
|
|||
|
|
Ú Ú ç ¤ ç “ ç – ç æ ç has_chunkÁ ç into_inner_with_chunkÁ Ú î ¤ î “ î Õ î ù9 î ˆ: î ¨ Ú õ ¤ õ “ õ – õ ”) Ú ú ¤ ú “ ú – ú º) ú Ï) Ú €
|
|||
|
|
¤ €
|
|||
|
|
“ Ú StreamReaderProjectÁ ƒ
|
|||
|
|
Þ ƒ
|
|||
|
|
¤ ƒ
|
|||
|
|
“ ƒ
|
|||
|
|
¨ ƒ
|
|||
|
|
chunkÁ Ú ‰
|
|||
|
|
¤ ‰
|
|||
|
|
“ ‰
|
|||
|
|
projectÁ Ú �
|
|||
|
|
¤ �
|
|||
|
|
“ �
|
|||
|
|
– �
|
|||
|
|
¥ �
|
|||
|
|
¥ �
|
|||
|
|
² �
|
|||
|
|
Ö �
|
|||
|
|
Ä �
|
|||
|
|
è � ��������� �
|
|||
|
|
Œ Ú ¢
|
|||
|
|
‚6 ¢
|
|||
|
|
Ä ¢
|
|||
|
|
receiver_wakerÁ ¢
|
|||
|
|
sender_wakerÁ ¢
|
|||
|
|
bufÁ Œ ¨
|
|||
|
|
× Œ ReceiverÁ ª
|
|||
|
|
¨ Œ ¬
|
|||
|
|
× Œ SenderÁ ®
|
|||
|
|
¨ Œ °
|
|||
|
|
× Ú StreamReaderÁ ²
|
|||
|
|
¤ ²
|
|||
|
|
“ ²
|
|||
|
|
¨ ²
|
|||
|
|
Öh Ú ·
|
|||
|
|
¤ ·
|
|||
|
|
“ ·
|
|||
|
|
× DropGuardÁ »
|
|||
|
|
¨ ½
|
|||
|
|
× DropGuardRefÁ ¿
|
|||
|
|
Þ ¿
|
|||
|
|
¨ Â
|
|||
|
|
Þ Â
|
|||
|
|
× WaitForCancellationFutureÁ Å
|
|||
|
|
Þ Å
|
|||
|
|
† Å
|
|||
|
|
ý. É
|
|||
|
|
Ê
|
|||
|
|
Þ É
|
|||
|
|
__assert_not_repr_packedÁ Ì
|
|||
|
|
Þ É
|
|||
|
|
|
|||
|
|
ProjectionÁ Î
|
|||
|
|
'__pinÁ Î
|
|||
|
|
Þ Î
|
|||
|
|
† Î
|
|||
|
|
ý. É
|
|||
|
|
|
|||
|
|
ProjectionRefÁ Ó
|
|||
|
|
Þm Ó
|
|||
|
|
Þ Ó
|
|||
|
|
† Ó
|
|||
|
|
ý. Ê
|
|||
|
|
øh Ø
|
|||
|
|
Þm Ê
|
|||
|
|
project_refÁ Ú
|
|||
|
|
Þm É
|
|||
|
|
__OriginÁ Ü
|
|||
|
|
Þm Ü
|
|||
|
|
Þ Ü
|
|||
|
|
__dummy_lifetimeÁ Ü
|
|||
|
|
† Ü
|
|||
|
|
ý. É
|
|||
|
|
â
|
|||
|
|
Þm â
|
|||
|
|
Þ É
|
|||
|
|
MustNotImplDropÁ É
|
|||
|
|
æ
|
|||
|
|
¥ É
|
|||
|
|
è
|
|||
|
|
Þ WaitForCancellationFutureOwnedÁ ê
|
|||
|
|
ý. ê
|
|||
|
|
† í
|
|||
|
|
í
|
|||
|
|
¤m í
|
|||
|
|
Ìm ð
|
|||
|
|
Þm ð
|
|||
|
|
ý. ð
|
|||
|
|
† í
|
|||
|
|
„n ô
|
|||
|
|
Þm ô
|
|||
|
|
ý. ô
|
|||
|
|
† î
|
|||
|
|
øh ø
|
|||
|
|
Þm î
|
|||
|
|
Én ú
|
|||
|
|
Þm í
|
|||
|
|
än ü
|
|||
|
|
Þm ü
|
|||
|
|
„o ü
|
|||
|
|
ý. ü
|
|||
|
|
† í
|
|||
|
|
� Þm í
|
|||
|
|
Áo í
|
|||
|
|
„ ¥ í
|
|||
|
|
RunUntilCancelledFutureÁ ‡ Þ ‡ — ‡ cancellationÁ ‡ ý. Œ � Þ � — Œ ¤m � Þ � — Œ Ìm “ Þm “ Þ “ — “ —r “ ý. Œ „n ™ Þm ™ Þ ™ — ™ —r ™ ý. � øh Ÿ Þm � Én ¡ Þm Œ än £ Þm £ Þ £ — £ „o £ —r £ ý. Œ ª Þm ª Þ ª — Œ Áo Œ ¯ ¥ Œ ± Þ ± — RunUntilCancelledFutureOwnedÁ ´ — ´ —r ´ ý. ¸ ¹ — ¸ ¤m » — ¸ Ìm ½ Þm ½ — ½ —r ½ ý. ¸ „n  Þm  —  —r  ý. ¹ øh Ç Þm ¹ Én É Þm ¸ än Ë Þm Ë — Ë „o Ë —r Ë ý. ¸ Ñ Þm Ñ — ¸ Áo ¸ Õ ¥ ¸ × — �
|
|||
|
|
PollSendErrorÁ Ù
|
|||
|
|
Ù ¥ Ù ˆ �Ý ¥ Ý × � StateÁ à ¥ à IdleÁ â
|
|||
|
|
â ˆ à AcquiringÁ å
|
|||
|
|
à ReadyToSendÁ ç
|
|||
|
|
ç ˆ à ClosedÁ ê
|
|||
|
|
� ì ¥ ì × �
|
|||
|
|
PollSenderÁ ï ¥ ï senderÁ ï º ï acquireÁ �
|
|||
|
|
ô ¥ ô × � PollSenderFutureÁ ÷
|
|||
|
|
÷ ¥ ÷ ˆ � û ¥ û × ¬ EitherÁ þ � þ £ þ LeftÁ �
|
|||
|
|
� ˆ þ RightÁ „
|
|||
|
|
„ ˆ ¬‡ � ‡ £ ‡ × ¬‹ � ‹ £ ‹ ƒ èèèè RestoreOnPendingÁ ’
|
|||
|
|
è ”
|
|||
|
|
made_progressÁ è¹ œ WithCancellationTokenFutureÁ — Þ — — — ’ œ › œ Þ œ — › ¤m Ÿ Þ Ÿ — › Ìm ¢ Þm ¢ Þ ¢ — ¢ ’ › „n § Þm § Þ § — § ’ œ øh ¬ Þm œ Én ® Þm › än ° Þm ° Þ ° — ° „o ° ’ › ¶ Þm ¶ Þ ¶ — › Áo › » ¥ › ½ Þ ½ — œ WithCancellationTokenFutureOwnedÁ À — À ’ œÃ Ä — à ¤m Æ — à Ìm È Þm È — È ’ à „n Ì Þm Ì — Ì ’ Ä øh Ð Þm Ä Én Ò Þm à än Ô Þm Ô — Ô „o Ô ’ à ٠Þm Ù — à Áo Ã Ý ¥ Ã ß — ¹
|
|||
|
|
SinkWriterÁ á ¤ á ¨ ¹ ä ¤ ä × ¹ ç è ¤ ç ¤m ê ¤ ç Ìm ì Þm ì ¤ ì ¨ ç „n ð Þm ð ¤ ð ¨ è øh ô Þm è Én ö Þm ç än ø Þm ø ¤ ø „o ø ¨ ç ý Þm ý ¤ ç Áo ç �
|
|||
|
|
¥ ç ƒ
|
|||
|
|
¤ ÷ ReaderStreamÁ …
|
|||
|
|
£ …
|
|||
|
|
readerÁ …
|
|||
|
|
Íj …
|
|||
|
|
capacityÁ ÷Š
|
|||
|
|
£ Š
|
|||
|
|
× ÷ �
|
|||
|
|
Ž
|
|||
|
|
£ �
|
|||
|
|
¤m �
|
|||
|
|
£ �
|
|||
|
|
Ìm ’
|
|||
|
|
Þm ’
|
|||
|
|
£ ’
|
|||
|
|
û‚ ’
|
|||
|
|
Íj ’
|
|||
|
|
‘ƒ �
|
|||
|
|
„n ˜
|
|||
|
|
Þm ˜
|
|||
|
|
£ ˜
|
|||
|
|
û‚ ˜
|
|||
|
|
Íj ˜
|
|||
|
|
‘ƒ Ž
|
|||
|
|
øh ž
|
|||
|
|
Þm Ž
|
|||
|
|
Én
|
|||
|
|
Þm �
|
|||
|
|
än ¢
|
|||
|
|
Þm ¢
|
|||
|
|
£ ¢
|
|||
|
|
„o ¢
|
|||
|
|
û‚ ¢
|
|||
|
|
Íj ¢
|
|||
|
|
‘ƒ �
|
|||
|
|
©
|
|||
|
|
Þm ©
|
|||
|
|
£ �
|
|||
|
|
Áo �
|
|||
|
|
|
|||
|
|
¥ �
|
|||
|
|
¯
|
|||
|
|
£ ¬
|
|||
|
|
InspectWriterÁ ±
|
|||
|
|
¨ ±
|
|||
|
|
— ±
|
|||
|
|
writerÁ ±
|
|||
|
|
± ¬ ¶
|
|||
|
|
·
|
|||
|
|
¨ ·
|
|||
|
|
— ¶
|
|||
|
|
¤m º
|
|||
|
|
¨ º
|
|||
|
|
— ¶
|
|||
|
|
Ìm ½
|
|||
|
|
Þm ½
|
|||
|
|
¨ ½
|
|||
|
|
— ½
|
|||
|
|
ô… ½
|
|||
|
|
± ¶
|
|||
|
|
„n Ã
|
|||
|
|
Þm Ã
|
|||
|
|
¨ Ã
|
|||
|
|
— Ã
|
|||
|
|
ô… Ã
|
|||
|
|
± ·
|
|||
|
|
øh É
|
|||
|
|
Þm ·
|
|||
|
|
Én Ë
|
|||
|
|
Þm ¶
|
|||
|
|
än Í
|
|||
|
|
Þm Í
|
|||
|
|
¨ Í
|
|||
|
|
— Í
|
|||
|
|
„o Í
|
|||
|
|
ô… Í
|
|||
|
|
± ¶
|
|||
|
|
Ô
|
|||
|
|
Þm Ô
|
|||
|
|
¨ Ô
|
|||
|
|
— ¶
|
|||
|
|
Áo ¶
|
|||
|
|
Ù
|
|||
|
|
¥ ¶
|
|||
|
|
Û
|
|||
|
|
¨ Û
|
|||
|
|
— ¬
|
|||
|
|
InspectReaderÁ Þ
|
|||
|
|
£ Þ
|
|||
|
|
— Þ
|
|||
|
|
û‚ Þ
|
|||
|
|
± ¬ã
|
|||
|
|
ä
|
|||
|
|
£ ä
|
|||
|
|
— ã
|
|||
|
|
¤m ç
|
|||
|
|
£ ç
|
|||
|
|
— ã
|
|||
|
|
Ìm ê
|
|||
|
|
Þm ê
|
|||
|
|
£ ê
|
|||
|
|
— ê
|
|||
|
|
û‚ ê
|
|||
|
|
± ã
|
|||
|
|
„n ð
|
|||
|
|
Þm ð
|
|||
|
|
£ ð
|
|||
|
|
— ð
|
|||
|
|
û‚ ð
|
|||
|
|
± ä
|
|||
|
|
øh ö
|
|||
|
|
Þm ä
|
|||
|
|
Én ø
|
|||
|
|
Þm ã
|
|||
|
|
än ú
|
|||
|
|
Þm ú
|
|||
|
|
£ ú
|
|||
|
|
— ú
|
|||
|
|
„o ú
|
|||
|
|
û‚ ú
|
|||
|
|
± ã
|
|||
|
|
�Þm �£ �— ã
|
|||
|
|
Áo ã
|
|||
|
|
†¥ ã
|
|||
|
|
ˆ£ ˆ— ‘ CopyToBytesÁ ‹¤ ‹¨ ‘Ž¤ Ž× ‘ ‘ ’¤ ‘¤m ”¤ ‘Ìm –Þm –¤ –¨ ‘„n šÞm š¤ š¨ ’øh žÞm ’Én Þm ‘än ¢Þm ¢¤ ¢„o ¢¨ ‘§Þm §¤ ‘Áo ‘«¥ ‘¤ ° FramedWriteÁ ¯¥ ¯– ¯¨ ° ³ ´¥ ´– ³¤m ·¥ ·– ³Ìm ºÞm º¥ º– º¨ ³„n ¿Þm ¿¥ ¿– ¿¨ ´øh ÄÞm ´Én ÆÞm ³än ÈÞm È¥ È– È„o Ȩ ³ÎÞm Î¥ Ζ ³Áo ³Ó¥ ³Õ¥ Õ– û
|
|||
|
|
FramedReadÁ Ø¥ Ø• ب û Ü Ý¥ Ý• ܤm à¥ à• ÜÌm ãÞm 㥠㕠㨠܄n èÞm è¥ è• è¨ Ýøh íÞm ÝÉn ïÞm Üän ñÞm ñ¥ ñ• ñ„o ñ¨ Ü÷Þm ÷¥ ÷• ÜÁo Üü¥ Üþ¥ þ• µ FramedÁ �¥ �¦ �¨ µ … †¥ †¦ …¤m ‰¥ ‰¦ …Ìm ŒÞm Œ¥ Œ¦ Œ¨ …„n ‘Þm ‘¥ ‘¦ ‘¨ †øh –Þm †Én ˜Þm …än šÞm š¥ š¦ š„o š¨ … Þm ¥ ¦ …Áo …¥¥ …§¥ §¦ ô
|
|||
|
|
FramedImplÁ ª¥ ª¦ ªÙw ª¨ ªº ªï1 ô ±¥ ±¦ ±Ùw ±× ô ¶ ·¥ ·¦ ·Ùw ¶¤m »¥ »¦ »Ùw ¶Ìm ¿Þm ¿¥ ¿¦ ¿Ùw ¿¨ ¿º ¿ï1 ¶„n ÇÞm Ç¥ Ǧ ÇÙw Ǩ Ǻ Çï1 ·øh ÏÞm ·Én ÑÞm ¶än ÓÞm Ó¥ Ó¦ ÓÙw Ó„o Ó¨ Óº Óï1 ¶ÜÞm Ü¥ ܦ ÜÙw ¶Áo ¶â¥ ¶ä¥ ä¦ äÙw
|
|||
|
|
|
|||
|
|
|
|||
|
|
*
|
|||
|
|
1
|
|||
|
|
2
|
|||
|
|
3
|
|||
|
|
4
|
|||
|
|
4
|
|||
|
|
4
|
|||
|
|
8
|
|||
|
|
8
|
|||
|
|
9
|
|||
|
|
9
|
|||
|
|
:
|
|||
|
|
;
|
|||
|
|
=
|
|||
|
|
M
|
|||
|
|
M
|
|||
|
|
M
|
|||
|
|
O
|
|||
|
|
Q
|
|||
|
|
V
|
|||
|
|
W
|
|||
|
|
X
|
|||
|
|
Y
|
|||
|
|
\
|
|||
|
|
]
|
|||
|
|
g
|
|||
|
|
g
|
|||
|
|
g
|
|||
|
|
k
|
|||
|
|
k
|
|||
|
|
k
|
|||
|
|
m
|
|||
|
|
m
|
|||
|
|
m
|
|||
|
|
p
|
|||
|
|
s
|
|||
|
|
s
|
|||
|
|
s
|
|||
|
|
|
|
|||
|
|
|
|
|||
|
|
|
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
ž
|
|||
|
|
ž
|
|||
|
|
ž
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
±
|
|||
|
|
µ
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
·
|
|||
|
|
¸
|
|||
|
|
¹
|
|||
|
|
º
|
|||
|
|
»
|
|||
|
|
¾
|
|||
|
|
Â
|
|||
|
|
Â
|
|||
|
|
Â
|
|||
|
|
Ã
|
|||
|
|
Ã
|
|||
|
|
Ã
|
|||
|
|
Ä
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Ý
|
|||
|
|
Þ
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
á
|
|||
|
|
á
|
|||
|
|
á
|
|||
|
|
â
|
|||
|
|
ã
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
è
|
|||
|
|
ê
|
|||
|
|
ê
|
|||
|
|
ê
|
|||
|
|
ì
|
|||
|
|
…
|
|||
|
|
‡
|
|||
|
|
‰
|
|||
|
|
�
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
“
|
|||
|
|
•
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
ª
|
|||
|
|
Á
|
|||
|
|
Á
|
|||
|
|
Á
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
Ê
|
|||
|
|
Î
|
|||
|
|
Ï
|
|||
|
|
Ï
|
|||
|
|
Ï
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
×
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
ä
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
ö
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
¹
|
|||
|
|
¹
|
|||
|
|
¹
|
|||
|
|
À
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
ò
|
|||
|
|
ò
|
|||
|
|
”
|
|||
|
|
–
|
|||
|
|
˜
|
|||
|
|
š
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
¬
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
Ð
|
|||
|
|
Ñ
|
|||
|
|
Ò
|
|||
|
|
Ó
|
|||
|
|
Ô
|
|||
|
|
Ø
|
|||
|
|
Ù
|
|||
|
|
Ú
|
|||
|
|
Û
|
|||
|
|
Ü
|
|||
|
|
Ý
|
|||
|
|
Þ
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
ë
|
|||
|
|
ë
|
|||
|
|
ë
|
|||
|
|
ì
|
|||
|
|
í
|
|||
|
|
í
|
|||
|
|
í
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
ò
|
|||
|
|
ò
|
|||
|
|
ò
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
’
|
|||
|
|
”
|
|||
|
|
•
|
|||
|
|
™
|
|||
|
|
š
|
|||
|
|
›
|
|||
|
|
¡
|
|||
|
|
¡
|
|||
|
|
¡
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
¨
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
Æ
|
|||
|
|
Ç
|
|||
|
|
È
|
|||
|
|
Ê
|
|||
|
|
Ë
|
|||
|
|
Ï
|
|||
|
|
Ð
|
|||
|
|
Ñ
|
|||
|
|
Ò
|
|||
|
|
Ó
|
|||
|
|
Ú
|
|||
|
|
Ú
|
|||
|
|
Ú
|
|||
|
|
Û
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
â
|
|||
|
|
â
|
|||
|
|
â
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
„
|
|||
|
|
…
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
‡
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
›
|
|||
|
|
œ
|
|||
|
|
�
|
|||
|
|
ž
|
|||
|
|
Ÿ
|
|||
|
|
¡
|
|||
|
|
¢
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¦
|
|||
|
|
¨
|
|||
|
|
ª
|
|||
|
|
¬
|
|||
|
|
|
|||
|
|
®
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
È
|
|||
|
|
É
|
|||
|
|
Ë
|
|||
|
|
Ï
|
|||
|
|
Ï
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
ò
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
ø
|
|||
|
|
ø
|
|||
|
|
ü
|
|||
|
|
ü
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
”
|
|||
|
|
”
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
˜
|
|||
|
|
˜
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
¾
|
|||
|
|
¾
|
|||
|
|
¾
|
|||
|
|
Á
|
|||
|
|
Ç
|
|||
|
|
Ç
|
|||
|
|
Ç
|
|||
|
|
É
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ô
|
|||
|
|
Û
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
ß
|
|||
|
|
â
|
|||
|
|
â
|
|||
|
|
ä
|
|||
|
|
ä
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
ñ
|
|||
|
|
ñ
|
|||
|
|
ñ
|
|||
|
|
ù
|
|||
|
|
û
|
|||
|
|
û
|
|||
|
|
û
|
|||
|
|
ý
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
‚
|
|||
|
|
‚
|
|||
|
|
„
|
|||
|
|
„
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
ž
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
½
|
|||
|
|
¿
|
|||
|
|
Â
|
|||
|
|
Â
|
|||
|
|
Â
|
|||
|
|
Â
|
|||
|
|
Â
|
|||
|
|
Æ
|
|||
|
|
Æ
|
|||
|
|
Æ
|
|||
|
|
Æ
|
|||
|
|
Ç
|
|||
|
|
Ç
|
|||
|
|
Ç
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
Ê
|
|||
|
|
Î
|
|||
|
|
Ð
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
×
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
¥
|
|||
|
|
¥
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
§
|
|||
|
|
¨
|
|||
|
|
©
|
|||
|
|
ª
|
|||
|
|
«
|
|||
|
|
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
±
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
¶
|
|||
|
|
·
|
|||
|
|
·
|
|||
|
|
·
|
|||
|
|
·
|
|||
|
|
·
|
|||
|
|
É
|
|||
|
|
Ê
|
|||
|
|
Ð
|
|||
|
|
Ð
|
|||
|
|
Ð
|
|||
|
|
Ð
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
ì
|
|||
|
|
ñ
|
|||
|
|
ò
|
|||
|
|
ó
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
ÿ
|
|||
|
|
Œ
|
|||
|
|
|
|||
|
|
“
|
|||
|
|
|
|||
|
|
“
|
|||
|
|
|
|||
|
|
“
|
|||
|
|
|
|||
|
|
”
|
|||
|
|
|
|||
|
|
•
|
|||
|
|
|
|||
|
|
•
|
|||
|
|
|
|||
|
|
•
|
|||
|
|
|
|||
|
|
–
|
|||
|
|
|
|||
|
|
–
|
|||
|
|
|
|||
|
|
–
|
|||
|
|
|
|||
|
|
©
|
|||
|
|
|
|||
|
|
©
|
|||
|
|
|
|||
|
|
©
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
±
|
|||
|
|
|
|||
|
|
±
|
|||
|
|
|
|||
|
|
±
|
|||
|
|
|
|||
|
|
º
|
|||
|
|
|
|||
|
|
º
|
|||
|
|
|
|||
|
|
º
|
|||
|
|
|
|||
|
|
¾
|
|||
|
|
|
|||
|
|
¾
|
|||
|
|
|
|||
|
|
¾
|
|||
|
|
|
|||
|
|
Ä
|
|||
|
|
|
|||
|
|
Ä
|
|||
|
|
|
|||
|
|
Ä
|
|||
|
|
|
|||
|
|
Ì
|
|||
|
|
|
|||
|
|
ï
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
»
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Ž
|
|||
|
|
•
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
Ÿ
|
|||
|
|
Æ
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
ê
|
|||
|
|
Œ
|
|||
|
|
|
|||
|
|
Œ
|
|||
|
|
|
|||
|
|
Œ
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
|
|||
|
|
º
|
|||
|
|
|
|||
|
|
ç
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
”
|
|||
|
|
·
|
|||
|
|
à
|
|||
|
|
‰
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
»
|
|||
|
|
è8 è8_8 äïá¤ûÒ“ª…Ø
|
|||
|
|
¬
|
|||
|
|
€
|
|||
|
|
å
|
|||
|
|
ƒ ® Ô º Ü ¿Š ‡ ‡ ˆÆO ‰ˆ È ýJ >�²î Ûá± Øá± ¿cá± ™á± Ðìá± µßá±á± ºá± íßá±á± šeá± ³ á± äá± ïá±"Â" BytesÁ "õ "£ "Ä‘"£ "Å dataÁ"£ "Æ vtableÁ"£ NÍâíŠá ïá±"¿"¿ BytesMutÁ "Àµ "™ "Á‘"™ " capÁ"™ "ÃÒ²"™ )Ö1^ÔvÏ ¿c ª ª “• ®¨ ¯º °ï1 x
|
|||
|
|
ä'†ý3¿ ¥¦Ùw “í ª ª “• ®¨ ¯º °ï1 x
|
|||
|
|
ä'†ý3¿¥¦Ùw á·µ áó´ ¿c ž ž ãP ŸôP ÿP ¡ô5 ¢šQ ìJÝ(…ž/ ³ ¥ ¥ ºQ ¦ÊQ §ÖQ •ÁA½+úô ³ Ķ ³ ˆ ˆ â5 ‰ô5 Š‚6 ƸðÐzo¡C é ĶŽ´ é ã·Ž´ ™·Ä¶ £™·Ä¶ ™·ã· £™·ã· 'E ª ª “• ®¨ ¯º °ï1 x
|
|||
|
|
ä'†ý3¿·µ½µ£
|
|||
|
|
ª ª “• ®¨ ¯º °ï1 x
|
|||
|
|
ä'†ý3¿·µ›¶¨š “í � � Ò’ „¨ µ çwpW…r}X•¶›¶ ¤·µ ¤ � � Ò’ „¨ µ çwpW…r}X·µ½µ 'Eüº
|
|||
|
|
� � Ò’ „¨ µ çwpW…r}X·µ›¶¥º ¿cüº ¿c ª ª ïQ ’R ®ï1 ¯¤R °´R ±³E { ä�áT·µ½µ “í Ø Ø �� Û¨ û ›F}pøc•¶• û·µ û Ø Ø �� Û¨ û ›F}pøc·µ• 'E¼½
|
|||
|
|
Ø Ø �� Û¨ û ›F}pøc·µ¤½¥º ¿c¼½ “í ¯ ¯ Ç� ²¨ ° Ír°k0Fo•¶– Ò·µ Ò ¯ ¯ Ç� ²¨ ° Ír°k0Fo·µ–
|
|||
|
|
¯ ¯ Ç� ²¨ ° Ír°k0Fo·µ†¿¥º 'E ¯ ¯ Ç� ²¨ ° Ír°k0Fo·µï½ ¿c ¯ ¯ Ç� ²¨ ° Ír°k0Fo·µ½µ ¿c ¶ ¶ êR ·ùR è ¸ŽS è ¹¾H è ºÙH è »òH è ¼¾S è ñÆ0w,g‡ ÛšÁ ØšÁ Š šÁ ¿c à à „T ÄÍE è ź è Ú¸h¼* ج ¿c Ê Ë ÌÝT Í ÎîT ψ è Æõ/(ðí†i Ûø Øø Š ø ä¬Â ï¬Â¢³ ³ ¬Â “ “ “ “ “ ³ šÁ ¿c ÿ ÿ ’E €³E è í^³h
|
|||
|
|
ª‹V ÄcÄÄ ¾ ÄÄ Ø Ö Ö «U ×½U ¹ ØÐK ¹ Ù×U ¹ Y ÷Eú ¿c�Å ™�Å Ðì�Å µß�Å�Å º�Å íß�Å�Å še�Å ä�Å ï�Å·µ ³ �Å ¿c ê ë ìëV í î�W ïˆ ê)µGù Ø= ÄcÙÆ é ÙÆßß ¥ à… ¬
|
|||
|
|
ÑøÿËO Ÿ ¾ ÙÆ Ø ò ò ±W ó½U à ôÐK à õ×U à öâW à ÷ùW à ~ý3̘Í; ¿cîÇ ™îÇ ÐìîÇ µßîÇîÇ ºîÇ íßîÇîÇ šeîÇ äîÇ ïîÇ·µ ³ îÇ ¿c ˆ ‰ Š–Y ‹ Œ�W �ˆ { Þ”íݬ& ÄcÐÉ é ÐÉ®Ç ¾ ÐÉ ¿c ‹ ‹ ¬‹ �¨ ‘ yî‚$7ŒÙ³ ¤ “í ‹ ‹ ¬‹ �¨ ‘ yî‚$7ŒÙ³¤ ª·µ ª»Ê
|
|||
|
|
øÊ Þ
|
|||
|
|
'E»Ê “í Þ
|
|||
|
|
Þ
|
|||
|
|
Àˆ á
|
|||
|
|
û‚ ¬ â
|
|||
|
|
± ¬ €´
|
|||
|
|
5eµF£— …·µ … Þ
|
|||
|
|
Þ
|
|||
|
|
Àˆ á
|
|||
|
|
û‚ ¬ â
|
|||
|
|
± ¬ €´
|
|||
|
|
5eµF £— �ÄÌ ÃÄÌ “í ±
|
|||
|
|
±
|
|||
|
|
Ï… ´
|
|||
|
|
ô… ¬ µ
|
|||
|
|
± ¬ 7†„€[¿%¨¬Ì Ø
|
|||
|
|
·µ Ø
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
Ï… ´
|
|||
|
|
ô… ¬ µ
|
|||
|
|
± ¬ 7†„€[¿% ¨†Í ÂΠ�‚Î ‚Ø ê ê ëÆ^ ïˆ Ü ð‰ Ü O2“M¤ópä ަ̓ ¿c …
|
|||
|
|
…
|
|||
|
|
ß‚ ‡
|
|||
|
|
û‚ ÷ ˆ
|
|||
|
|
Íj ÷ ‰
|
|||
|
|
‘ƒ ÷ H&tK^øâ€Í “í …
|
|||
|
|
…
|
|||
|
|
ß‚ ‡
|
|||
|
|
û‚ ÷ ˆ
|
|||
|
|
Íj ÷ ‰
|
|||
|
|
‘ƒ ÷ H&tK^øâ¦Ì ¬
|
|||
|
|
·µ ¬
|
|||
|
|
»Ï 'E»Ï ¿c ¢
|
|||
|
|
¢
|
|||
|
|
Ú £
|
|||
|
|
‚6 Œ ¤
|
|||
|
|
Ä Œ ¥
|
|||
|
|
£j Œ ¦
|
|||
|
|
¹j Œ §
|
|||
|
|
Íj Œ m¸cÏUŸ\ ¿c ª
|
|||
|
|
ª
|
|||
|
|
åj «
|
|||
|
|
¨ Œ * ·Š ¸� Œ"éÑ �éÑ ¿c ®
|
|||
|
|
®
|
|||
|
|
Šk ¯
|
|||
|
|
¨ Œ 1\wìþòÎ Œ"´Ò Ã´Ò ¿c á á Å€ ã ¨ ¹ u8"Õ´!«ŒêÊ “í á á Å€ ã ¨ ¹ u8"Õ´!«Œ§Ë €
|
|||
|
|
·µ €
|
|||
|
|
ÿÒ ÃÿÒ 'EÿÒ �ÿÒ ¿c ²
|
|||
|
|
²
|
|||
|
|
k µ
|
|||
|
|
¨ Ú ¶
|
|||
|
|
Öh Ú œ?E¤*k(êÊ“ �ªÔ tªÔ “íªÔ
|
|||
|
|
ªÔ¥ ¿c »
|
|||
|
|
»
|
|||
|
|
ýk ¼
|
|||
|
|
¨ Ù»háþ),g Œ"¦Õ ¿c ¿
|
|||
|
|
¿
|
|||
|
|
¡l Á
|
|||
|
|
¨ Ó0Xj˜]R Þ Œ" ¿
|
|||
|
|
¿
|
|||
|
|
¡l Á
|
|||
|
|
¨ Ó0Xj˜]R 8 «½ H H É I¨ �bO³r< ¬½ÙÖ “í Å
|
|||
|
|
Å
|
|||
|
|
Øl Ç
|
|||
|
|
† È
|
|||
|
|
ý. %‹™ßK¤ÃK Þ å
|
|||
|
|
·µ å
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Øl Ç
|
|||
|
|
† È
|
|||
|
|
ý. %‹™ßK¤ÃK Þ “í ê
|
|||
|
|
ê
|
|||
|
|
ño ë
|
|||
|
|
ý. ì
|
|||
|
|
† J|]E“wk ƒ ·µ ƒ Ø ¿cÙÖ ØÙÖ Œ"ÙÖ ³ ÙÖ ¿cç× ‚Øç× ¿cØ ‚ØØ “í ‡ ‡ èq Š —r ‹ ý. L‚@Ó°ÍÜë Þ¬Ì ® ·µ ® ‡ ‡ èq Š —r ‹ ý. L‚@Ó°ÍÜë Þ†Í ‚Ø±Ú “í ´ ´ ät ¶ —r · ý. ÚP7>_Š†Í Ô ·µ Ô ´ ´ ät ¶ —r · ý. ÚP7>_Š — ‚ØÕÛ ¿c Ù Ù Ú šw Ü ˆ � C]˜è ÷ZÆ·µ Äc¦Ü ¾ ¦Ü ¿c à â ã îw ä ˆ � å æ ‡x ç è �x é ˆ � ê ë ½x o슡;šÈš·µ ¿c ï ï åx ñ ÿx � ò º � ó •y � A,úqaƒ·µ ¿c ÷ ÷ ø ¹y ú ˆ � 9ŒJñ
|
|||
|
|
ûÓ ·µ ØòÝ
|
|||
|
|
òÝ·µ 'E Ø Ø á! Ùö! É Ú‡" É ¼ç¨ùÑtóž Ø˜ß ¿c˜ß à ˜ßŸ^Ÿ^ SemaphoreÁ ^ ll_semÁÄU Ê}Õ¹ iQ ‚Ø ü ü ¿$ ÿè$ î �Êðß”Ti 8•¶ � ¸à ¿c¸à Œ" ž ž ú& ¡± î – ÁB9# †Í ¿c þ � ‚ ™z ƒ ˆ „ … ²z † ˆ µ‹_-u �¦Ì ØËá ‚ØËá �Ëá tËá ©Ëá ÃËá 'EËá
|
|||
|
|
Ëá› Œ" ð ð ñ¹, óˆ é ÇñËÙzWŒJ·µ ‚Ø ð ð ñ¹, óˆ é ÇñËÙzWŒJ�Ü “í — — Ô{ š ’ œ ÃI?ïÒŒ Þ¬Ì º ·µ º — — Ô{ š ’ œ ÃI?ïÒŒ Þ†Í ‚ØÆä “í À À ª~  ’ œ 0Ì#Åø>í†Í Ü ·µ Ü À À ª~  ’ œ 0Ì#Åø>í�Ü ‚ØÖå ¿·µ Š ‡Â ¶Õ Ê‹ ‡¿ ¶Ò ÊŒ ‡À ¶È ÃÓ ÊÚ Öø òN H¼ ï ç Ø‹ þ Ž ‡± ª£ žï �² ª« Øã ¯½ ¶Æ ÃРʱ ÿÜ Öð êú òŽ ˆŽ ‹Š
|
|||
|
|
…
|
|||
|
|
¨
|
|||
|
|
¢
|
|||
|
|
¬
|
|||
|
|
ª
|
|||
|
|
°
|
|||
|
|
®
|
|||
|
|
ä á ·
|
|||
|
|
²
|
|||
|
|
½
|
|||
|
|
»
|
|||
|
|
Â
|
|||
|
|
¿
|
|||
|
|
L He Å
|
|||
|
|
l ê
|
|||
|
|
Ý Ù ì à ô ï û ÷ é Ø• ü‡ þ � ‡Þ Öü ò’ ‡à Öþ ò“ ‡á Öÿ ò• ‡ã Ö� ò— ‡å Öƒ ò™ ‡ç Ö… òœ ‡¨ ¥‹ ž� ˆ� ï ¶Ö Öý òR HÒ ‡ˆ ÃÌ Öó òÖ ‡Ù ‡Œ ÃÒ Öù òÜ ª �÷ ØÎ ¯§ ‹� Þ
|
|||
|
|
Ô
|
|||
|
|
±
|
|||
|
|
©
|
|||
|
|
…
|
|||
|
|
ý á €
|
|||
|
|
²
|
|||
|
|
â
|
|||
|
|
Å
|
|||
|
|
� ê
|
|||
|
|
ª ‡ Ñ ´ ¶ — Ù À â ä ª� ž‘ ˆÚ ê� ˆ“ ¥— ¥• ¥™ ¥› ªá �� ØÞ ¯¨ ‹‡ …
|
|||
|
|
Ó á ä ØØ þ ¥ ªæ �¢ ØÕ ¯ ‹�
|
|||
|
|
²
|
|||
|
|
¿ ï Ý þ ¥ § �ü þ ØÓ Õ ¯”•–—˜ ³ ÿØ êÿ ˆœ Ù µ ÿÜ êƒ ˆŸ Ù « ‹† ˆ Þ
|
|||
|
|
¿ Þ
|
|||
|
|
Ø ±
|
|||
|
|
® ª
|
|||
|
|
× á õ ²
|
|||
|
|
 þ à Þ
|
|||
|
|
Ð ±
|
|||
|
|
² ®
|
|||
|
|
Ì á Ð þ Ù
|
|||
|
|
Û
|
|||
|
|
±
|
|||
|
|
ñ êh Å
|
|||
|
|
q ê
|
|||
|
|
x ‡ } ´ � ü¼ þ ú ð — ¶ À
|
|||
|
|
¯
|
|||
|
|
…
|
|||
|
|
¬ ª
|
|||
|
|
° ®
|
|||
|
|
»
|
|||
|
|
¿
|
|||
|
|
P H§ žô ð�
|
|||
|
|
ƒ
|
|||
|
|
á ú ²
|
|||
|
|
Æ þ J HK Hæ
|
|||
|
|
è
|
|||
|
|
Å
|
|||
|
|
„ † ê
|
|||
|
|
¯ ± ‡ Õ × ´ ë Ø“ üË þ » ½ — Ý ß À  Š Ä
|
|||
|
|
ÛØ
|
|||
|
|
¿c"D™êÐìµßºíßše³ ä= ï “í# ápé
|
|||
|
|
£'E
|
|||
|
|
? ¤8 û
|
|||
|
|
Ò
|
|||
|
|
“
|
|||
|
|
Äc¾ ª …
|
|||
|
|
�
|
|||
|
|
Ã* Ø
|
|||
|
|
#‚Ø
|
|||
|
|
|
|||
|
|
¬
|
|||
|
|
BŒ"
|
|||
|
|
€
|
|||
|
|
-t
|
|||
|
|
«½¬½ å
|
|||
|
|
ƒ
|
|||
|
|
®
|
|||
|
|
Ô
|
|||
|
|
à
|
|||
|
|
� © º Ü
|
|||
|
|
¿
|
|||
|
|
_ÁD± ± $µ 5 8 6 j ü‘) ‡ ,© £ / _Á _Á _Á _ÁLº 5 B ÓË Â ü“1 í ’õ ,² äô � äô • 6 b",;\n\r"Á $ì 5 B ’õ ï üÅ, î ’õ ,ä œö Š œö ’ 6 b","Á _Á _Á _Á
|
|||
|
|
ü« Ï é€ÍèÔ “Ø“Ø ”ØÎ •Øˆä o
|
|||
|
|
³Î¢½ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
®Ç €Í èÔ Á Î
|
|||
|
|
‰Ì üø ŠÚ ‚ù ¤¸ ê €ÍèÔ (ŒÍ
|
|||
|
|
ˆØ ê ê ëÆ^ ïˆ Ü ð‰ Ü O2“M¤ópä €ÍèÔ … i Ð�¸ �ú ‡ Ž �ú ¦«
|
|||
|
|
öX �ú À É Í
|
|||
|
|
Úß
|
|||
|
|
„Ø�ú ò
|
|||
|
|
Š * œØ¥ø A M ç È ¥ø ú œØ ¥ø & Ç Ó Ú
|
|||
|
|
µ
|
|||
|
|
à þ é : øŽ« Ï ! (
|
|||
|
|
f t ΄
|
|||
|
|
A Ò Žù
|
|||
|
|
Í Ö ß = ò ú & 0
|
|||
|
|
|
|||
|
|
®Û÷ C & - ! k Û÷ v Ì�Ì� k Î�´¸� Ï� local_wakerÁ¸� Ð� extÁ¸� Ñ� _markerÁ¸� Ò� _marker2Á¸� f'EwÚ]¾å üø $Ì ‚ù Ú á �ú ù �ú ' üø $ ‚ù È �ú ² X / œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã¥ø } „¾„¾ PinÁ †¾‰ ˜X $ ]È=„kt•°û º °û à °û Ì Ä€ h Ä€ q Ä€ ç ï ¥ø ‹ ’ Ä€ Ä Ì Ô Ü ä ì ¥ø z ‚ þ� ÊQŠ üø Íj’ ‚ù ÊQ® Íj° û7 �ú � L ó œØ ( 3
|
|||
|
|
é B % , œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã ¯ Û÷ ¸ Ä€ Á É �ú; û « T X Æ ®‚ „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•Ù÷ C Ä€ L üø F ‚ù E�ú 6 �ú d ®‚ H ü‚ Q °û Z Ä€ c k ¥ø Ä€ } ¶ Ù÷ ¿ þÊ ÊQÇ üø ÍjÏ ‚ù ÊQë Íjí ût �ú � ‰ 0 ˆú
|
|||
|
|
ªû Þû ÊQÍj�ú¾ û ƒ Ö Ú H �úè û r 4096Á _Á "simplex has been closed"Á _Á _Á _Áü—Kè
|
|||
|
|
`�Ü ì÷ ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ�Ü ƒØ ÙÖ �Ü ƒ �
|
|||
|
|
,ÒJ
|
|||
|
|
(¨ÒJ
|
|||
|
|
ÓŒ ©ÙJ
|
|||
|
|
�Ü œ¤K
|
|||
|
|
d©K
|
|||
|
|
|
|||
|
|
X $¤K
|
|||
|
|
t©K
|
|||
|
|
) $ÆK
|
|||
|
|
Û¼ ÅŒ ü¡KØ
|
|||
|
|
|
|||
|
|
„ L
|
|||
|
|
L¥L
|
|||
|
|
|
|||
|
|
Y $ L
|
|||
|
|
\¥L
|
|||
|
|
ÊL
|
|||
|
|
üèKt
|
|||
|
|
‡ �Ü («êL
|
|||
|
|
|
|||
|
|
ˆØ ‡ ‡ èq Š —r ‹ ý. L‚@Ó°ÍÜë �Ü x _ ø¬èK‡
|
|||
|
|
Á� † Á� ž£
|
|||
|
|
öX Á� ¸ Á Å
|
|||
|
|
Ò×
|
|||
|
|
„ØÁ� ê
|
|||
|
|
Œ
|
|||
|
|
ø ü
|
|||
|
|
|
|||
|
|
¨
|
|||
|
|
" œØ€Œ 9 E é
|
|||
|
|
È €Œ ÿ «îL
|
|||
|
|
Á�
|
|||
|
|
þL
|
|||
|
|
( ÿL
|
|||
|
|
œØ €Œ & } Á� y Ž � ¼ Ì 7 r € [ a v | ` – ø—Kè
|
|||
|
|
Ý ä  # Ð # ¡ ¨ » Á� Ó øL
|
|||
|
|
Õ Ý í ø ÿ o x ? l s y ?
|
|||
|
|
G W b i r
|
|||
|
|
| † � ÷
|
|||
|
|
�Ü ) 0 7 > E L U _
|
|||
|
|
|
|||
|
|
®í‹ r Ü ã µ ¼ $ š í‹ ¥ Ä€ ® ÓŒ �Ü ÙJ
|
|||
|
|
Ä ÓŒ · Á� Á� 4 Å
|
|||
|
|
Å
|
|||
|
|
Øl Ç
|
|||
|
|
† È
|
|||
|
|
ý. %‹™ßK¤ÃK À ÓŒ ³ �Ü « Á� E | œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã€Œ Ê „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•Ú� Ú� Ú� Ä€ ½ Ä€ Æ Ä€ 2 : €Œ à ç Ä€ S [ Ö û # €Œ l t þ $ÓJ
|
|||
|
|
ÓŒ futÁà �Ü
|
|||
|
|
ö›þ û– Á� � « è ù œØ (
|
|||
|
|
` 6 § y € °† _ í‹ h Ä€ q y Á�U 2 û —K
|
|||
|
|
Þ š Á „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•ë‹ ü Ä€
|
|||
|
|
ÓŒ j �Ü W Á� V Á� � Ù × �Ü ¹ š z ûš ƒ Ú� Œ Ä€ • � €Œ CÄ€ ¯ €Œ ‰
|
|||
|
|
‘
|
|||
|
|
ë‹ š
|
|||
|
|
þ¥
|
|||
|
|
& ÓŒ ö› �Ü 0
|
|||
|
|
ö›! û¹ Á� � Î í�
|
|||
|
|
ËŽ» º�S Ô�Z ˆ‘a Á�ùÁ� �Üê�Üñ ö›Á�- û Ð ç ë Á�W û ú × ü•S3
|
|||
|
|
d�Ü ì÷ €ŒÙÖ�Ü 2 ? ¯ÑR
|
|||
|
|
ÙÖ ÙÖ °×R
|
|||
|
|
�Ü $ŸS
|
|||
|
|
ÙÖ ìŸS
|
|||
|
|
œ¤S
|
|||
|
|
|
|||
|
|
]�Ü 3 ¸S
|
|||
|
|
|
|||
|
|
ĤS
|
|||
|
|
(²½S
|
|||
|
|
|
|||
|
|
ˆØí‹ N
|
|||
|
|
% ø³ŸS#
|
|||
|
|
í‹ D K í‹ ch
|
|||
|
|
öXë‹ z ƒ ‡
|
|||
|
|
”™
|
|||
|
|
„Øí‹ ¬
|
|||
|
|
ˆ º ¾ Ê ã œØ€Œ ù â È €Œ ²ÁS
|
|||
|
|
í‹
|
|||
|
|
|
|||
|
|
´ÇS
|
|||
|
|
ÙÖ ÈS
|
|||
|
|
œØ €Œ & f í‹
|
|||
|
|
b ÙÖ Š – �
|
|||
|
|
Ø
|
|||
|
|
æ Á Ç Ü â d ü ø´•S3
|
|||
|
|
B I ' 5 R Y Ä l í‹ „ ÇS
|
|||
|
|
€ ˆ ‘ ÙÖ © ± Ì Õ è d
|
|||
|
|
k â ê ó ÙÖ '
|
|||
|
|
1 ; E ` i s } �Ü ” �Ü « ÙÖ À Ç Î Õ Þ è
|
|||
|
|
|
|||
|
|
®ž£ û ÿ > E # ž£ . Ä€ 7 ÙÖ $ÑR
|
|||
|
|
�Ü ×R
|
|||
|
|
í‹ ƒ í‹ ¾ ÓŒ à �Ü ± í‹ ~ € · š À ¡Ÿ É ë‹ Ò ë‹ Û Ä€ » Ä€ Ä Ä€ ö þ €Œ Þ å Ä€ $ , €Œ ) 1 þ< ÙÖ ö› �Ü + ÙÖ ö›7 û“ í‹ � ¨ « ¼ Ê œØ à ë
|
|||
|
|
d ù ý < C °† " ž£ + Ä€ 4 < ÙÖ í‹Z û •S
|
|||
|
|
B F ¥ š ˆ „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•œ£ à Ā Ì �Ü ‹í‹
|
|||
|
|
í‹ H ÓŒ j š ( ¡Ÿ 1 ë‹ : Ä€ C K €Œ +Ä€ ] 6 œ£ ? þJ ÙÖ ö› �Ü 9 ÙÖ ö›E û¡ í‹ � ¶ ¹ º¤% ì¤ú Ë¥ ü¥í‹ìÙÖÖí‹úÙÖä ö›ÙÖÈ �Ü _ û Ä h ÙÖ šµU û û < @ Ÿ _Á _Áüö ê ¤·µ ì÷ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
‰M‰M OwnedPermitÁ ‹M chanÁìL yòÚ'ØyJc·µ¦Üۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙúLúL Šk üL®¶ìL 訋øæ´÷R·µ 4 B ¸¯ ×· ×· $‚
|
|||
|
|
×· Tü � ùØž"#ù½ž"#
|
|||
|
|
°c ùÓµ.# Z˜‹ 9 4–
|
|||
|
|
×·Û œ¸ ü¡
|
|||
|
|
# lµ
|
|||
|
|
|
|||
|
|
ÅM·µ 4¡
|
|||
|
|
|µ
|
|||
|
|
(ºÒ
|
|||
|
|
|
|||
|
|
ˆØÇM·µ ì÷ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
�·¦\¦\ §\ SendErrorÁ ©\ˆ P@T‡#Í�è œ¸ î È ø»¡
|
|||
|
|
6 éº ç î éº
|
|||
|
|
öX éº " , 1
|
|||
|
|
?E
|
|||
|
|
„Øéº Y
|
|||
|
|
“ h m z
|
|||
|
|
‹ œØ¶ ¢ ® é È ýº ºÖ
|
|||
|
|
éº ¼í
|
|||
|
|
¥·µ Ï»¦Ü ü¡
|
|||
|
|
d <å
|
|||
|
|
|
|||
|
|
ç[�·Ï»¦Ü ¥·µÒ¾ ü¡
|
|||
|
|
6 k
|
|||
|
|
üå
|
|||
|
|
à œØ Â¶ & ù×�@#á×�#
|
|||
|
|
ÜW > ' ñ éº
|
|||
|
|
|
|||
|
|
ô
|
|||
|
|
D J _ e ¤ € ø¾ö ê ü‘
|
|||
|
|
t c j ¯ , ½ , É Ð Û" ã éº û „
|
|||
|
|
¾ß $ [ d f k s
|
|||
|
|
z ‚ ‰ i p x ‚ ‰ ’ ›
|
|||
|
|
¤
|
|||
|
|
« ' ×· À ' Ð Ù â ë ò * ×· * P Y c m ×· ‚ ‰ � — ž § ±
|
|||
|
|
|
|||
|
|
®®¶ Ä D ? § - ì ®¶ ÷ Ä€ ×· $¯ d‘
|
|||
|
|
œ¸ 6ýº ¢ éº ö éº . œ¸ éº E Q ! œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãýº o „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•ì¼ ª ì¼ ³ ì¼ ¼ Ä€ ù Ä€ Ä€ × ß ýº # Ä€ ø ˆ¿ ! ù×Üì# Œ äÈäÈ ArgumentsÁ æÈ templateÁ ` çÈÀ ` üöMõô]Td „ µ ½ Å Í Õ Ý ¼ Ä Ì Ô Ü ä ì ¶ #
|
|||
|
|
+
|
|||
|
|
þ6
|
|||
|
|
Ò²: ×· Ò²M ×· ÿx… ûs éº � ˆ •
|
|||
|
|
¦
|
|||
|
|
´
|
|||
|
|
œØ Ê
|
|||
|
|
Õ
|
|||
|
|
|
|||
|
|
¤ ä
|
|||
|
|
d _ À Ç °†
|
|||
|
|
®¶ Ä€ ' ×·. éº; Ò²û ö À Ä + œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã¶ º „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•¬¶ õ Ä€ þ ô œ¸ )
|
|||
|
|
éº à éº
|
|||
|
|
úÆ ò ÈÇ û ì¼
|
|||
|
|
Ä€
|
|||
|
|
|
|||
|
|
ýº R Ä€ '
|
|||
|
|
ˆ¿ H ¦ öÈ Ï
|
|||
|
|
¶ � ‰ ¬¶ ’ þ� Ò²¡ ×· Ò²´ ×· ÿxì
|
|||
|
|
ûÚ éº � ï ü ܹ^ ´º âºÝ
|
|||
|
|
æ¼ä
|
|||
|
|
Ÿ½ë
|
|||
|
|
éº% ö¾æ ú¿oéº: Ò²×·G ·µÆM[
|
|||
|
|
Ò²û ß ã J ×·‡ ñД
|
|||
|
|
Ò²û Y ƒ IJ ¬·µ ì÷ ¶ , 9 ùݽD# Áݽ#
|
|||
|
|
àW ùÝÖ*# (˜‹ 4 ƒ Ž – › ¯ ¬ ½ È Õ å í ö ÿ
|
|||
|
|
|
|||
|
|
®òÑ òÑ ( Ä€ 1 í ¶ @ H þS \ m { œØ ‘ œ
|
|||
|
|
¬ « °† ¸ òÑ Á Ä€ Ê Ò ² Ê �Í þ „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•ðÑ 9 Ä€ B þ Q ðÑ Z þe n ÂÒ. ¤ ¢ ¥ ¸ ¶ ¹ @ 64Á @ MAX_BUFSÁ _Á _Á¬÷ ‡ ˆ % á± 1 8 ? $û~
|
|||
|
|
Ê Î % ø 1 8 ? û; ê î % ÙÆ 1 ®Ç 9 @ ½F ˆ Œ % ÐÉ 1 ®Ç 9 @ ÔÙ ê ¦Ì®Ï % ë 2 ê ê ëÆ^ ïˆ Ü ð‰ Ü O2“M¤ópä ¦Ì®Ï ‚ ¦Ì � ®Ï ˜ Ÿ Ü— Ù ·µ Ú ) ¦Ü 5 ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ·µ ‚ ‰ $þ à ·µ ã ) ùÜ 5 œ¸ = D \¢ à ·µ è ) ùÜ 5 �· = D Ôº ÷ ·µ ø ) ÃÞ 5 ü ü ¿$ ÿè$ î �Êðß”Ti ¶ m t $¿ þ “â¦Ì ‚ - Ëá 9 “â A H ,Ì þ “â¦Ì … - Ëá 9 ¦Ì A H üº " ð ·µ ñ * €ã 6 ÑÛÑÛ MaybeUninitÁ ÓÛ uninitÁÝ ÔÛ»Ý Íõƒ«%9·µ � ” ¬è›ÅÇ�À ö ,¶ " çü Ø ü±% " Utilities for working with Tokio.Á ×ú üÛ9 6 This crate is not versioned in lockstep with the coreÁ ü•@ = [`tokio`] crate. However, `tokio-util` _will_ respect Rust'sÁ üÖK H semantic versioning policy, especially with regard to breaking changes.Á ü¿ üá"|¥ ¬è›ÅÇ�À| ö } " çš� <° ´ ´ L
|
|||
|
|
Ä , , * , 8÷ $! & % 8÷ $&
|
|||
|
|
+ *. 1  , ; < » + J K b 8â L O a 8» <P X 7ï1 <Z + p q Ÿ 8ä Dr z ž 8 docsrsÁ 4{ $ � 8Ó ƒ † � 8â ‡ Š œ 8» <‹ “ 7ï1 <• , 8÷ $®
|
|||
|
|
¼ ¼ÇTÔ ß Ž å ô , æ ç ò , è 8÷ $é & í 8÷ $î
|
|||
|
|
ó *ö ù Œ , ƒ „ … + ’ “ « 8â ” — ª 8» <˜ 7× D¢ + ¹ º é 8ä D» à è 8áå 4Ä $ Ê 8Ó Ì Ï ç 8â Ð Ó æ 8» <Ô Ü 7× DÞ , ÷ 8÷ $ø
|
|||
|
|
† ¤‘<ž ¦ ÿ ¬ » , ® ¹ , ¯ 8÷ $° & ´ 8÷ $µ
|
|||
|
|
º *½ À ý , Ê Ë ö + Ù Ú ‡ 8â Û Þ † 8£ ß â … 8» <ã ë 7µ ,í $ ò 8» <ô ü 7ï1 <þ + • – Ú 8ä D— Ÿ Ù 8áå 4 $ ¦ 8Ó ¨ « Ø 8â ¬ ¯ × 8£ ° ³ Ö 8» <´ ¼ 7µ ,¾ $ Ã 8» <Å Í 7ï1 <Ï , è 8÷ $é
|
|||
|
|
÷ œ‚4� – ½ œ « , � ž © , Ÿ 8÷ $ & ¤ 8÷ $¥
|
|||
|
|
ª * ° » , º » ´ + É Ê Þ 8â Ë Î Ý 8» <Ï × 7’R $Ù + ì í ˜ 8ä Dî ö — 8áå 4÷ $ ý 8Ó ÿ ‚ – 8â ƒ † • 8» <‡ � 7’R $‘ , ¦ 8÷ $§
|
|||
|
|
µ œ½4Ê Ñ ø × æ , Ø Ù ä , Ú 8÷ $Û & ß 8÷ $à
|
|||
|
|
å *è ë ö , õ ö ï + „ … ™ 8â † ‰ ˜ 8» <Š ’ 7î $” + § ¨ Ó 8ä D© ± Ò 8áå 4² $ ¸ 8Ó º ½ Ñ 8â ¾ Á Ð 8» <Â Ê 7î $Ì , á 8÷ $â
|
|||
|
|
ð ¼û Tˆ
|
|||
|
|
“
|
|||
|
|
… ™
|
|||
|
|
¨
|
|||
|
|
, š
|
|||
|
|
›
|
|||
|
|
¦
|
|||
|
|
, œ
|
|||
|
|
8÷ $�
|
|||
|
|
& ¡
|
|||
|
|
8÷ $¢
|
|||
|
|
|
|||
|
|
§
|
|||
|
|
*ª
|
|||
|
|
|
|||
|
|
ƒ , ·
|
|||
|
|
¸
|
|||
|
|
ü
|
|||
|
|
+ Æ
|
|||
|
|
Ç
|
|||
|
|
à
|
|||
|
|
8â È
|
|||
|
|
Ë
|
|||
|
|
ß
|
|||
|
|
8”
|
|||
|
|
Ì
|
|||
|
|
Ï
|
|||
|
|
Þ
|
|||
|
|
8» <Ð
|
|||
|
|
Ø
|
|||
|
|
7î $Ú
|
|||
|
|
, î
|
|||
|
|
8÷ $ï
|
|||
|
|
|
|||
|
|
ý
|
|||
|
|
¬ˆ D• ž É ¤ ³ , ¥ ¦ ± , § 8÷ $¨ & ¬ 8÷ $
|
|||
|
|
² *µ ¸ Ç ,  à À + Ñ Ò è 8â Ó Ö ç 8» <× ß 7� 4á + ö ÷ ¤ 8ä Dø € £ 8áå 4� $ ‡ 8Ó ‰ Œ ¢ 8â � � ¡ 8» <‘ ™ 7� 4› , ² 8÷ $³
|
|||
|
|
Á Dº $¾ œx $‡ K £ †J ¤,¨ µ> ¥T¯ ½T L— :<+- dŽ ô Synchronization primitivesÁ $– �ÉîýkLa »
|
|||
|
|
…¡ldw ¿
|
|||
|
|
†ÉŒ… H ‡Øl̘ Å
|
|||
|
|
ˆñoô· ê
|
|||
|
|
‰èq¼þ ‡ ‹ätä— ´ ŒšwlÐ Ù ÇåxTß ï Èá!l™ Ø í¿$ŒÑ ü «´ ”$ HÅ
|
|||
|
|
ê
|
|||
|
|
‡ ´ É
|
|||
|
|
í
|
|||
|
|
Œ ¸ K Ú
|
|||
|
|
†J > ¹,lð
|
|||
|
|
ð ? — FutureÁ4‘
|
|||
|
|
‚Ø @ˆ‚ ¨
|
|||
|
|
„¾ Ak<¾
|
|||
|
|
Ì� C·$Ç
|
|||
|
|
œØ DýkLÚ
|
|||
|
|
»
|
|||
|
|
E¡ldô
|
|||
|
|
¿
|
|||
|
|
F pin_projectÁ\˜
|
|||
|
|
G¤ƒ
|
|||
|
|
,’
|
|||
|
|
»
|
|||
|
|
ÉŒ H ‡ôtÐ ¦Õ ü™, üåJ G Returns stored cancellation token and removes this drop guard instanceÁ ü´F C (i.e. it will no longer cancel token). Other guards for this tokenÁ ¬ÿ are not affected.Á4 ¦ÕÙÖ
|
|||
|
|
$«¼¸ ¦Õ �" ”Ö$Ù è è¦Õ Þ
|
|||
|
|
$ãÄ™
|
|||
|
|
L¨
|
|||
|
|
¿
|
|||
|
|
ÉŒ H ‡ôÌÀ Þ åÕ Åü”0 üàJÀý ü¯F”þ ¬úãþ4› åÕ ÞÙÖ
|
|||
|
|
Þ$¦ô· 8 é é ŸÖ �" ”Ü$ß ê êŸÖ ä
|
|||
|
|
8$él³
|
|||
|
|
L·
|
|||
|
|
%+123489:;=K £ †J " ¤,¨ µ> # ¥T¯ ½T $ Œ�CE13 !Ô» DÍ % % ™ &¨ '´ N�‡4Bïi N�‡4Bïi &'œÜ,Ü % % µ>µ> ¤ ·>¨£> ¸> poisonÁ£> ¹>Ò²£> Ë»™z™g— + + Ú ,æ -ó .„ /“ 0¦ 3|íáßSç1 Ôõ,õ % % š]š] NotifyÁ ›]ºâR œ] waitersÁâR x‹óÖ�q˜
|
|||
|
|
l“ Ø„)* ܧ µ Ø„ ( (
|
|||
|
|
) üòCD€ ë ëØ„ Æ]Æ] NotifiedÁ È] notifyÁâR É]ºâR Ê] notify_waiters_callsÁâR Ë] waiterÁâR qhY 4Ü ë ( ‰ (
|
|||
|
|
* $Šdâ ,é „† 3|íáßSç1 ,-./0ìõ4õ + + ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ†J†J K ‰Jµ �7 ŠJ phantomÁ�7 ‹J¤�7 ·0ØQd�èØ„çEçEèE GlobalÁ ¿±‡§í# Œ˜T˜ + + ä¯D¯ + + ªBªB ö BÍj÷< ®B‘÷< 9)
|
|||
|
|
-ÜnLÙŠ©‹”ÑdÑ + + ”é\é + + ü±8d¿ ì ìÙŠ Ò
|
|||
|
|
1 nodeÁ$Ìü´ATÂ í íÙŠ ÙŠ Õ
|
|||
|
|
2 æ4ÍüÕ"(œØ" î  ò"
|
|||
|
|
3 ºŒ$ì"üÑ+žÜÔ+ ñ ñÙŠ �Ü“ — 5 “ 6 5 6 þ+ Íì�Ü ð+ Íìœ� ó+ ï ð –"�ܽT½T ¥ ÀT lockÁ£> ÁTÖ„£> 0ªk¥a ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ½T½T ¥ ÀT—�£> ÁTÖ„£> 0ªk¥a ð„† ü«,C ï ð �Ü‚�˜" œ� ë,
|
|||
|
|
4�Üœ�ºŒ$ø+ funcÁ$Ž,MP KN ¼ú,d…-ü¡=@¼¤= ò ó ò„† ó„† Â=
|
|||
|
|
8 ºŒ$¼=æ4Î=ü BDd£B ô õ ô„†½T½T ¥ ÀT—�£> ÁTÖ„£> 0ªk¥a õ„† ¸B
|
|||
|
|
9 æ4°BºŒ$ÈBüÕJ<ÄãJ ö öÙŠ ‚K
|
|||
|
|
: ºŒ$üJü×N<ÄåN ÷ ÷ÙŠ „O
|
|||
|
|
; ºŒ$þN”úP ; <closure_kind>Á < <closure_signature>Á < <upvars>Á < < ; < ½T½T ¥ ÀT—�£> ÁTÖ„£> 0ªk¥a „†Û¼Ý¼Þ¼© ß¼ à¼ÛἈ cSñŸ«‡zÙ½T½T ¥ ÀT—�£> ÁTÖ„£> 0ªk¥a „† ü�Y*4žY ø øÙŠ «Y
|
|||
|
|
= ºŒ$¥Y´Ç
|
|||
|
|
rÔã
|
|||
|
|
c¤ƒ
|
|||
|
|
Mt�
|
|||
|
|
?T±
|
|||
|
|
36%(„Ó
|
|||
|
|
¼é
|
|||
|
|
ì†
|
|||
|
|
ø
|
|||
|
|
äá
|
|||
|
|
ü¦M
|
|||
|
|
J A token which can be used to signal a cancellation request to one or moreÁ Tô
|
|||
|
|
tasks.Á ÿ
|
|||
|
|
ú üƒA
|
|||
|
|
> Tasks can call [`CancellationToken::cancelled()`] in order toÁ üÅJ
|
|||
|
|
G obtain a Future which will be resolved when cancellation is requested.Á �
|
|||
|
|
ú ü”S
|
|||
|
|
P Cancellation can be requested through the [`CancellationToken::cancel`] method.Á è
|
|||
|
|
ú tì
|
|||
|
|
# ExamplesÁ û
|
|||
|
|
ú lÿ
|
|||
|
|
|
|||
|
|
```no_runÁ ´�
|
|||
|
|
use tokio::select;Á ü¤,
|
|||
|
|
) use tokio_util::sync::CancellationToken;Á Ñ
|
|||
|
|
ú ”Õ
|
|||
|
|
#[tokio::main]Á ¬è
|
|||
|
|
async fn main() {Á üþ-
|
|||
|
|
* let token = CancellationToken::new();Á ü¬)
|
|||
|
|
& let cloned_token = token.clone();Á Ö
|
|||
|
|
ú üÚ3
|
|||
|
|
0 let join_handle = tokio::spawn(async move {Á üŽ?
|
|||
|
|
< // Wait for either cancellation or a very long timeÁ ¬Î
|
|||
|
|
select! {Á üä1
|
|||
|
|
. _ = cloned_token.cancelled() => {Á ü– .
|
|||
|
|
+ // The token was cancelledÁ ¬Å
|
|||
|
|
5Á ŒÛ
|
|||
|
|
}Á üí Q
|
|||
|
|
N _ = tokio::time::sleep(std::time::Duration::from_secs(9999)) => {Á ´¿
|
|||
|
|
|
|||
|
|
99Á ŒÖ
|
|||
|
|
|
|||
|
|
õ lè
|
|||
|
|
|
|||
|
|
|
|||
|
|
}Á \ö
|
|||
|
|
|
|||
|
|
});Á ‚
|
|||
|
|
ú ü† !
|
|||
|
|
tokio::spawn(async move {Á ü¨ K
|
|||
|
|
H tokio::time::sleep(std::time::Duration::from_millis(10)).await;Á Üô
|
|||
|
|
token.cancel();Á \�
|
|||
|
|
¬¢ œ
|
|||
|
|
ú ü 2
|
|||
|
|
/ assert_eq!(5, join_handle.await.unwrap());Á ,Ó
|
|||
|
|
}Á <Ù
|
|||
|
|
```Á Œì
|
|||
|
|
ÙÖ �bO³r< I Qü„
|
|||
|
|
|
|||
|
|
,„
|
|||
|
|
H H ÙŠü¨
|
|||
|
|
1
|
|||
|
|
ÙÖ üÝ
|
|||
|
|
4
|
|||
|
|
ÙÖ üÊ +
|
|||
|
|
ÙÖM Àc M üü D
|
|||
|
|
ÿ
|
|||
|
|
ù ú û ùÙÖ ú c c ˆ ¢cµ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
ûÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ŸÈŸÈ È¥ O˜éBL L ƒ
|
|||
|
|
L
|
|||
|
|
M $„
|
|||
|
|
± Š
|
|||
|
|
üÇ
|
|||
|
|
ÙÖO Ù O ¼ÿ
|
|||
|
|
üî I
|
|||
|
|
F Creates a clone of the [`CancellationToken`] which will get cancelledÁ ü¼ >
|
|||
|
|
; whenever the current token gets cancelled, and vice versa.Á,‚!
|
|||
|
|
ü üÙÖ ÙÖ N ˆ!
|
|||
|
|
N
|
|||
|
|
O $‰!
|
|||
|
|
ü©"
|
|||
|
|
ÙÖQ �" Q ”Ï"
|
|||
|
|
$Ò"
|
|||
|
|
ý ýÙÖ P ×"
|
|||
|
|
P
|
|||
|
|
Q $Ü"
|
|||
|
|
ü§#"
|
|||
|
|
ÙÖS ´ S üÐ#!
|
|||
|
|
<Ó#
|
|||
|
|
ÙÖ R R
|
|||
|
|
S ´ž$
|
|||
|
|
ÙÖUVWXYZ[\]a üƒ%!
|
|||
|
|
ü»$C
|
|||
|
|
@ Creates a new [`CancellationToken`] in the non-cancelled state.Á Š%
|
|||
|
|
ÙÖ T T
|
|||
|
|
U üé0.
|
|||
|
|
ü‘&I
|
|||
|
|
F Creates a [`CancellationToken`] which will get cancelled whenever theÁ üß&H
|
|||
|
|
E current token gets cancelled. Unlike a cloned [`CancellationToken`],Á ü¬'>
|
|||
|
|
; cancelling a child token does not cancel the parent token.Á ï'
|
|||
|
|
ú ü÷'G
|
|||
|
|
D If the current token is already cancelled, the child token will getÁ üÃ(
|
|||
|
|
returned in cancelled state.Á è(
|
|||
|
|
ú tð(
|
|||
|
|
÷› ƒ)
|
|||
|
|
ú l‹)
|
|||
|
|
šœ ´�)
|
|||
|
|
°œ ü¸),
|
|||
|
|
Ðœ é)
|
|||
|
|
ú ”ñ)
|
|||
|
|
‘� ¬ˆ*
|
|||
|
|
¬� ü¢*-
|
|||
|
|
Ë� üÔ*.
|
|||
|
|
+ let child_token = token.child_token();Á ‡+
|
|||
|
|
ú ü�+3
|
|||
|
|
Áž üÇ+?
|
|||
|
|
þž ¬‹,
|
|||
|
|
ÆŸ ü¥,0
|
|||
|
|
- _ = child_token.cancelled() => {Á üÚ,.
|
|||
|
|
¬�-
|
|||
|
|
× Œ§-
|
|||
|
|
õ ü½-Q
|
|||
|
|
�¡ ´“.
|
|||
|
|
ê¡ Œ®.
|
|||
|
|
õ lÄ.
|
|||
|
|
–¢ \Ö.
|
|||
|
|
¬¢ æ.
|
|||
|
|
ú üî.!
|
|||
|
|
Í¢ ü”/K
|
|||
|
|
ø¢ Üä/
|
|||
|
|
Ì£ \„0
|
|||
|
|
¬¢ ”0
|
|||
|
|
ú üœ02
|
|||
|
|
Š¤ ,Ó0
|
|||
|
|
Ť <Ý0
|
|||
|
|
Ó¤\ð0
|
|||
|
|
þ þÙÖ ÙÖ T ü0
|
|||
|
|
T
|
|||
|
|
V $ý0
|
|||
|
|
¤Ç6
|
|||
|
|
ü‚2H
|
|||
|
|
E Cancel the [`CancellationToken`] and all child tokens which had beenÁ ¤Ï2
|
|||
|
|
derived from it.Á è2
|
|||
|
|
ú üð2C
|
|||
|
|
@ This will wake up all tasks which are waiting for cancellation.Á ¸3
|
|||
|
|
ú üÀ3I
|
|||
|
|
F Be aware that cancellation is not an atomic operation. It is possibleÁ üŽ4K
|
|||
|
|
H for another thread running in parallel with a call to `cancel` to firstÁ üÞ4J
|
|||
|
|
G receive `true` from `is_cancelled` on one child node, and then receiveÁ ü5H
|
|||
|
|
E `false` from `is_cancelled` on another child node. However, once theÁ üú5H
|
|||
|
|
E call to `cancel` returns, all child nodes have been fully cancelled.Á4Î6
|
|||
|
|
ÿ ÿÙÖ T Õ6
|
|||
|
|
T
|
|||
|
|
W $Ö6
|
|||
|
|
üÑ7"
|
|||
|
|
ü‘7;
|
|||
|
|
8 Returns `true` if the `CancellationToken` is cancelled.ÁdØ7
|
|||
|
|
€ €ÙÖ T å7
|
|||
|
|
T í�$æ7
|
|||
|
|
ü´;8
|
|||
|
|
ü®8L
|
|||
|
|
I Returns a [`Future`] that gets fulfilled when cancellation is requested.Á ÿ8
|
|||
|
|
ú ”‡9
|
|||
|
|
Equivalent to:Á ž9
|
|||
|
|
ú l¦9
|
|||
|
|
|
|||
|
|
```ignoreÁ ô¸9
|
|||
|
|
async fn cancelled(&self);Á <Û9
|
|||
|
|
Ó¤ ç9
|
|||
|
|
ú üï9J
|
|||
|
|
G The future will complete immediately if the token is already cancelledÁ ü¾:
|
|||
|
|
when this method is called.Á â:
|
|||
|
|
ú Ìê:
|
|||
|
|
# Cancellation safetyÁ ˆ;
|
|||
|
|
ú ü�;
|
|||
|
|
This method is cancel safe.ÁL»;
|
|||
|
|
� �ÙÖ Å
|
|||
|
|
Å
|
|||
|
|
Øl Ç
|
|||
|
|
† È
|
|||
|
|
ý. %‹™ßK¤ÃK � T Å;
|
|||
|
|
T ËŽ$Æ;
|
|||
|
|
üç@>
|
|||
|
|
üù<L
|
|||
|
|
§» Ê=
|
|||
|
|
ú ”Ò=
|
|||
|
|
ˆ¼ é=
|
|||
|
|
ú lñ=
|
|||
|
|
¯¼ üƒ>#
|
|||
|
|
async fn cancelled_owned(self);Á <«>
|
|||
|
|
Ó¤ ·>
|
|||
|
|
ú ü¿>J
|
|||
|
|
†½ üŽ?
|
|||
|
|
Ú½ ²?
|
|||
|
|
ú üº?G
|
|||
|
|
D The function takes self by value and returns a future that owns theÁ T†@
|
|||
|
|
token.Á •@
|
|||
|
|
ú Ì�@
|
|||
|
|
Ž¾ »@
|
|||
|
|
ú üÃ@
|
|||
|
|
½¾|î@
|
|||
|
|
ÙÖØ T T
|
|||
|
|
Z $þ@
|
|||
|
|
üƒC$
|
|||
|
|
üåA+
|
|||
|
|
( Creates a [`DropGuard`] for this token.Á •B
|
|||
|
|
ú ü�BH
|
|||
|
|
E Returned guard will cancel this token (and all its children) on dropÁ ¤êB
|
|||
|
|
unless disarmed.ÁTŠC
|
|||
|
|
ÙÖ¦Õ T T
|
|||
|
|
[ $•C
|
|||
|
|
üþD0
|
|||
|
|
üÝC.
|
|||
|
|
+ Creates a [`DropGuardRef`] for this token.Á �D
|
|||
|
|
ú ü˜DH
|
|||
|
|
¹Ã ¤åD
|
|||
|
|
ŠÄt…E
|
|||
|
|
‚ ‚ÙÖ ¿
|
|||
|
|
¿
|
|||
|
|
¡l Á
|
|||
|
|
¨ Ó0Xj˜]R ‚ T ”E
|
|||
|
|
T
|
|||
|
|
\ $•E
|
|||
|
|
ü®Jd
|
|||
|
|
üçET
|
|||
|
|
Q Runs a future to completion and returns its result wrapped inside of an `Option`Á üÀFT
|
|||
|
|
Q unless the [`CancellationToken`] is cancelled. In that case the function returnsÁ ü™G'
|
|||
|
|
$ `None` and the future gets dropped.Á ÅG
|
|||
|
|
ú tÍG
|
|||
|
|
# FairnessÁ àG
|
|||
|
|
ú üèGG
|
|||
|
|
D Calling this on an already-cancelled token directly returns `None`.Á ü´HB
|
|||
|
|
? For all subsequent polls, in case of concurrent completion andÁ üûH?
|
|||
|
|
< cancellation, this is biased towards the future completion.Á ¿I
|
|||
|
|
ú ÌÇI
|
|||
|
|
Ž¾ åI
|
|||
|
|
ú üíI<
|
|||
|
|
9 This method is only cancel safe if `fut` is cancel safe.Áœ»J
|
|||
|
|
ƒ ƒÙÖ �Ü�Ü ƒ _ T — ^ ^ ÒJ
|
|||
|
|
T Ë� ÏJ
|
|||
|
|
‚Ø�Ü 4‹K
|
|||
|
|
º¤HXö›Z&( ˆ®äJ
|
|||
|
|
]8 È È ] `�Ü ì÷ €Œ 8ÙÖ �Ü Íì�Ü 8 _ ] ‚Ø“Î l “ÎƒØ €Œ~ ‹Î„ ¥ÎŠ ´Î� ] €a ] <coroutine_kind>Á ` <resume_ty>Á `
|
|||
|
|
<yield_ty>Á ` <return_ty>Á ` Ë• ` ` ] í‹ü§Ri
|
|||
|
|
ü…MT
|
|||
|
|
ÊÆ üÞMT
|
|||
|
|
¨Ç ü·N'
|
|||
|
|
†È ãN
|
|||
|
|
ú üëNN
|
|||
|
|
K The function takes self by value and returns a future that owns the token.Á ¾O
|
|||
|
|
ú tÆO
|
|||
|
|
ÂÈ ÙO
|
|||
|
|
ú üáOG
|
|||
|
|
æÈ üPB
|
|||
|
|
·É üôP?
|
|||
|
|
ƒÊ ¸Q
|
|||
|
|
ú ÌÀQ
|
|||
|
|
Ž¾ ÞQ
|
|||
|
|
ú üæQ<
|
|||
|
|
ñÊÌ´R
|
|||
|
|
ÙÖ�Ü�Ü c T — b b T Ë� ÎR
|
|||
|
|
—Í4‰S
|
|||
|
|
|
|||
|
|
a�Ü�Rö›�R"$ ˆµâR
|
|||
|
|
a a ž£ ÍìœÒ # ‚ØœÒ 2 œÒƒØ €ŒD ‹ÓJ šÓP ©ÓV a CX a÷Í d ‘Î d ¦Î d ºÎ d Ë• d d a ž£üûS;
|
|||
|
|
Þ f f ç×g Àc g €T
|
|||
|
|
ü½TD
|
|||
|
|
ÀT
|
|||
|
|
„ … † „ç× … c c ˆ ¢cµ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
†å§ e ÄT
|
|||
|
|
e
|
|||
|
|
g Þ$ÅT
|
|||
|
|
± ËT
|
|||
|
|
üÊU1
|
|||
|
|
Þ i i ç×jk ƒØ „Ø k ÏU
|
|||
|
|
\‚V
|
|||
|
|
4‡V
|
|||
|
|
h h ü™V?
|
|||
|
|
$œV
|
|||
|
|
‡ ˆ ‰„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ‡ç× ˆÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ‰°† h «V
|
|||
|
|
h
|
|||
|
|
k Þ$¡V
|
|||
|
|
cxÁ·V
|
|||
|
|
ü“\8
|
|||
|
|
Øm Àc m üÒ\D
|
|||
|
|
Õ\
|
|||
|
|
Š ‹ Œ ŠØ ‹ c c ˆ ¢cµ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
Œå§ l Ù\
|
|||
|
|
l
|
|||
|
|
m $Ú\
|
|||
|
|
± à\
|
|||
|
|
üä]#
|
|||
|
|
Øop üŽ^5
|
|||
|
|
‘^
|
|||
|
|
ÙÖØ n n
|
|||
|
|
o †”•^
|
|||
|
|
üÛcv
|
|||
|
|
Tåc
|
|||
|
|
� �ÙÖ Æ]Æ] ¸‡ È]ɇâR É]ºâR Ê]ç‡âR Ë]‡ˆâR qhY 4Ü n �d
|
|||
|
|
n
|
|||
|
|
p †”ùc
|
|||
|
|
ü¨g.
|
|||
|
|
Ørs ƒØ „Ø s \Ýg
|
|||
|
|
4âg
|
|||
|
|
q q üôg?
|
|||
|
|
$÷g
|
|||
|
|
Ž � �„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ŽØ �Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å �°† q †h
|
|||
|
|
q
|
|||
|
|
s $üg
|
|||
|
|
õ×’h
|
|||
|
|
üžr2
|
|||
|
|
Þ u — v u v Íì†Í §r
|
|||
|
|
‚Ø†Í 4ªr
|
|||
|
|
±Úw £r
|
|||
|
|
!# ü×rO
|
|||
|
|
år
|
|||
|
|
µ‚†Í±Ú t t
|
|||
|
|
w ކ͆”ér
|
|||
|
|
ý.4”s
|
|||
|
|
ü™t=
|
|||
|
|
Þ y — z y z Âß ¢t
|
|||
|
|
Óß4¥t
|
|||
|
|
±Ú{| ƒØ „Ø | žt
|
|||
|
|
') \Ýt
|
|||
|
|
4ât
|
|||
|
|
x x ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ†Í ƒØüƒuI
|
|||
|
|
$†u
|
|||
|
|
‘ ’ “„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ‘±Ú ’Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å “œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã±Ú ƒØ x •u
|
|||
|
|
x
|
|||
|
|
| Þ†Í$‹u
|
|||
|
|
õסu
|
|||
|
|
ü‘{:
|
|||
|
|
— ~ ~ Ë� –{
|
|||
|
|
—Í4™{
|
|||
|
|
ÕÛ€ ƒØ „Ø € #% \Ò{
|
|||
|
|
4×{
|
|||
|
|
} } €Œüø{I
|
|||
|
|
$û{
|
|||
|
|
” • –„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ”ÕÛ •Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å –œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÕÛ ƒØ } Š|
|
|||
|
|
}
|
|||
|
|
€�Ü$€|
|
|||
|
|
õ×–|
|
|||
|
|
üÙ~/
|
|||
|
|
— ‚ ‚ Ë� Þ~
|
|||
|
|
—Í4á~
|
|||
|
|
ÕÛƒ ü�K
|
|||
|
|
�
|
|||
|
|
ÙÖ�ÜÕÛ � �
|
|||
|
|
ƒ�܆”¡
|
|||
|
|
ý.4È
|
|||
|
|
”@„Z¨7¼l�7�7’7„7‡7x7{7”ép7s7b7e7D· $»¡¦Ù Ú ï à ÷ ø SinkÁ$
|
|||
|
|
� Žˆ‚ & „¾ � �k<; Ì� � ‘·$D œØ � ’× U ¤, � ”í Z ë � •š¶\w ‰M � –Šk4› úL � —¿$Œ¯ ü � ˜ «” ½l ®L/ Ÿ¡Ž� O €‚prôd b̈ TĨ EÄÀ ¥ š š Íì·µ Å ¦Ü›
|
|||
|
|
ü¿$ üß& # Consumes the stored value, if any.Á Š ú ü’^ [ If this error was encountered when calling `start_send`/`send_item`, this will be the itemÁ üõE B that the caller attempted to send. Otherwise, it will be `None`.ÁTÆ ¦ÜíÛ ™ ™
|
|||
|
|
›·µ$Ñ üþ) ¥ � � Ëì ƒ ¦Üž Åc ž ü®: ± — ˜ ™ —¦Ü ˜ c c ˆ ¢cµ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
™å§ œ µ œ
|
|||
|
|
ž·µ$¶ × ¼ üš: ¥ Ëì Ÿ ¿c·µ T¢ ¦Ü üŠ k œ“ � ×··µ £ ¥ ¢ ¢ Ëì §
|
|||
|
|
¡·µÒ²$V ø¿Í ( ¡ ¡ ®¶ Íì�ò & ‚Ø�ò 5 �òƒØ ¶G óòM ‚óS ‘óY ¡ �^ ¡÷Í ¤ ‘Î ¤ ¦Î ¤ ºÎ ¤ Ë• ¤ ¤ ¡ ®¶ í
|
|||
|
|
¡–• ¥ ®• ¥ Ë• ¥ ¥ ¡ ˆ¿¼â \ç � Þ § ¥ ¨ ¨ § Í앶 ÷ ü ü ¿$ ÿè$ î �Êðß”Ti ÞÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
‰M‰M š¶ ‹M®¶ìL yòÚ'ØyJc•¶ Ù Ù Ú šw Ü ˆ � C]˜è ÷ZÆ•¶ó õ÷ Üð ¥ ª ª Ëì õ ÃÞ«
|
|||
|
|
”Ò ,Õ � ÃÞ © ©
|
|||
|
|
«·µ,² «÷Í ¬ ‘Î ¬ ¦Î ¬ ºÎ ¬ Ë• ¬ ¬ « òÑüÖ! ¥ ® ® Ëì Û Ìì·µ $Þ ÃÞ¯°± "$ „© ¬ � ÃÞ
|
|||
|
|
¯·µüÏZ $Ò � š › œ šÃÞ ›Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å œ�Í ×
|
|||
|
|
°·µ$Ü õ×â üñ, ô � � �ÃÞ×· ø
|
|||
|
|
±·µ$ý ÿx4ƒ Ü€ ¥ ³ ³ Ëì … ´ù$ˆ òÝ´µ¶·¸¹º» (* üÆ % ü¢ Creates a new `PollSender`.Á Í œ¸òÝ ² ²
|
|||
|
|
´·µÿx4Ñ ü’ $ T• � ž žòÝùÜ ² ²
|
|||
|
|
µ·µ$¥ ü‡&Z üù 6 3 Attempts to prepare the sender to receive a value.Á ´! ú ü¼!U R This method must be called and return `Poll::Ready(Ok(()))` prior to each call toÁ „–"
|
|||
|
|
`send_item`.Á «" ú ü³"^ [ This method returns `Poll::Ready` once the underlying channel is ready to receive a value,Á ü–#V S by reserving a slot in the channel for the item to be sent. If this method returnsÁ üñ#G D `Poll::Pending`, the current task is registered to be notified (viaÁ ü½$K H `cx.waker().wake_by_ref()`) when `poll_reserve` should be called again.Á �% ú d•% # ErrorsÁ ¦% ú ü®%T Q If the channel is closed, an error will be returned. This is a permanent state.ÁdŽ& Ÿ ¡ ŸòÝ Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ¡œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¦Ü ² ›& ²
|
|||
|
|
¶·µ$ & õצ& üç5E üŽ2! Sends an item to the channel.Á ´2 ú ü¼2V S Before calling `send_item`, `poll_reserve` must be called with a successful returnÁ ü—3# value of `Poll::Ready(Ok(()))`.Á ¿3 ú dÇ3 ì‚ Ø3 ú üà3T Žƒ ¹4 ú dÁ4 # PanicsÁ Ò4 ú üÚ4` ] If `poll_reserve` was not successfully called prior to calling `send_item`, then this methodÁ |¿5 will panic.Á ²|Ó5 Lî5 € ¢ ¢òÝ·µÜ† ² ø5 ²
|
|||
|
|
··µ$ý5 »,ƒ6 üæ= üà<) & Checks whether this sender is closed.Á Ž= ú ü–=K H The underlying channel that this sender was wrapping may still be open.ÁLí= £ £òÝ ² ÷= ²
|
|||
|
|
¸·µ$ø= ü±@+ üØ>? < Gets a reference to the `Sender` of the underlying channel.Á œ? ú ü¤?` ] If `PollSender` has been closed, `None` is returned. The underlying channel that this senderÁ ü‰@# was wrapping may still be open.Á<¸@ ¤ ¤òÝ Û¼Ý¼Þ¼© ß¼ à¼ÛἈ cSñŸ«‡zÙ
|
|||
|
|
< 9 - `Poll::Ready(Some(permit))` if a permit was acquired.Á üÙ
|
|||
|
|
< 9 - `Poll::Ready(None)` if the semaphore has been closed.Á š ú ü¢ K H When this method returns `Poll::Pending`, the current task is scheduledÁ üò D A to receive a wakeup when a permit becomes available, or when theÁ ü» L I semaphore is closed. Note that on multiple calls to `poll_acquire`, onlyÁ üŒ
|
|||
|
|
D A the `Waker` from the `Context` passed to the most recent call isÁ üÕ
|
|||
|
|
" scheduled to receive a wakeup.Ádƒ ´ µ ¶ ´˜ß µÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ¶œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÑ® Û � Û
|
|||
|
|
à $•õ×›üªŒ üŠ4 1 Poll to acquire many permits from the semaphore.Á Ãú üË)¡³ ùú ü�>à³ üÄ<¨´ ü…<î´ Æú üÎKÀµ üžF C to receive a wakeup when the permits become available, or when theÁ üéL㶠üºD¹· üƒ"‡¸Œ± · ¸ ¹ ·˜ß ¸Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ¹Ýº Û Ì Û
|
|||
|
|
á $Ñõ×ßô<ýüÑ$( ü¼"4 1 Returns the current number of available permits.Á õ"ú üý"L I This is equivalent to the [`Semaphore::available_permits`] method on theÁ üÎ#" `tokio::sync::Semaphore` type.Á õ#ú üý#O L [`Semaphore::available_permits`]: tokio::sync::Semaphore::available_permitsÁŒØ$ º º˜ß Û ê$ Û
|
|||
|
|
â $ë$ü·(# ü²%* ' Adds `n` new permits to the semaphore.Á á%ú üé%R O The maximum number of permits is [`Semaphore::MAX_PERMITS`], and this functionÁ üÀ&( % will panic if the limit is exceeded.Á í&ú üõ&F C This is equivalent to the [`Semaphore::add_permits`] method on theÁ üÀ'"ÙÀ ç'ú üï'C @ [`Semaphore::add_permits`]: tokio::sync::Semaphore::add_permitsÁ\¾( » »˜ß Û Ê( Û
|
|||
|
|
ã $Ë(¹ Ñ(ì�) ˜ßåæ 'F 'G æ L±)$¶) ä ä Ñ®üØ)^LÛ) ¼ ½ ¾„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ¼˜ß ½Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ¾Ýº ä ï) ä
|
|||
|
|
æ $å)õ×û)äñ* ˜ßè Ù è ü”+ ,—+ ¿ ¿˜ß ˜ß ç �+ ç
|
|||
|
|
è $ž+üï+! ˜ßê Àc ê ü—,8 š, À Á  À˜ß Á c c ˆ ¢cµ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
Âå§ é ž, é
|
|||
|
|
ê $Ÿ,± ¥,üÊ-' ˜ßì â ì ôø-4û- Ã Ã˜ß Ãóß ë ‚. ë
|
|||
|
|
ì $ƒ.ì‰Æh„© dü˜ž 4 èØ î ï× ! ¤, î ðý.$8 ä î òÛû4> ‚Ø î óí$V ë î õ ManuallyDropÁd\ ÃÛ î öˆ‚ y „¾ î ÷µ ‡ “ î øk<œ Ì� î ú·$¥ œØ î û”ÞD Î\*¿4/¯±DK¡ P†ˆlowD‚hL�Z\HJüï# ü> ; A reusable `Pin<Box<dyn Future<Output = T> + Send + 'a>>`.Á ìú üðC @ This type lets you replace the future stored in the box withoutÁ ü´: 7 reallocating when the size and alignment permits this.Á Œú Þ ý ¥ þ ý þ õ � ü ü ¿$ ÿè$ î �Êðß”Ti Þ•¶ �Êðß”Ti ÿŒXZ ü™3,™î ü ü „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•�� ž BoxÁ ¡ˆˆ ¢‰ˆ l }.xÏ ‚Ø ƒØ •¶ Ìì Þ©‹üÑ$ Þ � ¥ ‚ � ‚ õ Ú€Òƒ…‡�Ž Ö üÈU üüG D Create a new `ReusableBoxFuture<T>` containing the provided future.Á Ï ¬Ì€Ò €— „ „ € Íì¬Ì Ó ‚Ø¬Ì ”þ ¬ÌƒØ •¶T… Ìì¬Ì $“ ¬Ì Þš
|
|||
|
|
ƒ Þ•¶¬Ìý.4Ödf �ü½X üí4 1 Replace the future currently stored in this box.Á ¦ú ü®H E This reallocates if and only if the layout of the provided future isÁ üû= : different from the layout of the currently stored future.Á Ä Ä Ä€Ò¬Ì €— † † Ë € „Ö È •Ö”ö ¦ÖTý ºÖ$‹ ËÖ’
|
|||
|
|
… Þ•¶¬Ì$Ðý.4ÖFH �üö
|
|||
|
|
m üŒ 4”Ö Å ú üÍ I F This function never reallocates, but returns an error if the providedÁ ü›
|
|||
|
|
F C future has a different size or alignment from the currently storedÁ \æ
|
|||
|
|
future.Á<ý
|
|||
|
|
ŠŀҬÌÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¬Ì €— ˆ ˆ ˆ € „Ö … •Ö”Ä ¦ÖTË ºÖ$Ù ËÖà
|
|||
|
|
‡ Þ•¶¬Ì$� ý.4“ FH �ü�³d� î Æ Æ ü ü ¿$ ÿè$ î �Êðß”Ti Þ�â†ÍÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
†Í Þ Š — ‹ ‹ Š · Âß ¡ Óß4 Ìì†Í $¶ †Í Þ½
|
|||
|
|
‰ Þ†Í thisÁ$±ý.4ê�UW Š<Œ ‰–• Œ ®• Œ Ë• Œ Œ ‰ Œ †Í �� ž»Ò ¡ˆˆ ¢‰ˆ l }.xφͩ‹ „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•�� ž»Ò ¡ˆˆ ¢‰ˆ l }.xÏ ‚Ø ƒØ �â Ìì©‹ü¥F üì4 1 Get a pinned reference to the underlying future.Á<¬ Ç Ç€Ò„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• Ç ‚Ø ƒØ •¶ Ìì Ç € ´ €
|
|||
|
|
� Þ•¶$¹üÅ7 ü•+ ( Poll the future stored inside this box.Á$Ì È É Ê È€Ò ÉÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ÊœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã•¶ € Ñ €
|
|||
|
|
Ž Þ•¶$Öõ×Üü¨+ 8 Ë ¥ � Ë � õ ¸à‘’ ƒØ „Ø ’ \Ú4ß � � •¶ü > üð+™ä$£ Ì Í Î„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ̸à ÍÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å Îúæ � ² �
|
|||
|
|
’ 8•¶$¨õ×¾üÕ0 8 Ï ¥ ” ” Ï õ á¸à
|
|||
|
|
üŠ/ 8 Ð ¥ – – Ð õ �¸à— Àc — üÀ8 Ã Ñ Ò Ó Ñ¸à Ò c c ˆ ¢cµ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
Óå§ • Ç •
|
|||
|
|
— 8•¶$ȱ Îü¹…l¼ î „¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt•�� ž»Ò ¡ˆˆ ¢‰ˆ l }.xÏ·µ©‹½µ—Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
½µ ¥ ™ ¦ š › — œ œ › ™ š Îì·µ Ê Íì½µ Õ ÍìÜï Ø Íì‰ï Û –"‰ï�� ž»Ò ¡ˆˆ ¢‰ˆ l }.xϽµ©‹ œª ‰ïüð˜" Üï ¼
|
|||
|
|
˜·µ½µÜï‰ïè$,Þ new_valueÁLò callbackÁD€åç áã Ýß ÙÛ ¶ ˜–• � ®• � Ë• � � ˜ �·µ½µÜï‰ï Üï ·µ ½µ‰ïüÀ#& TÇ#î Ÿ — Ÿ Íìºá Ò# Âß Õ# –"†Í lØ# †Í ˜" ºá ä#Œá – ÁB9# ¡ ªRT WY ”í# í#î ž ž ÃÛÃÛ ²Í ÅÛ»¬ „ µÜÀ,�%*†Íü„$* £ — ¤ £ ¤ ·ô ›$ Âß Œ$ ¤ôl�$ ‹ô ‰$Œá¥¦ +- ¤µ$ ¸$ î †ÍŒá ¢ ¢
|
|||
|
|
¥ºá†Í± ¼$”�%$’% î Œáºá ¢ ¢
|
|||
|
|
¦ºá†Í$—%ü¥&3 ¨ — © © ¨ ·ô ¼& Âß & ¤ôl°& ‹ô ª&Œáª �" ª 02 ”ß&$â& Ô ÔŒá § ç& §
|
|||
|
|
ªºá†Í$ì&üà ´~t� ü # Module defining an Either type.Á 4¥ þ Ûû4; ‚Ø ¬ ® SeekFromÁDK ñL ¬ ¯ˆ‚ ^ „¾ ¬ °k<n Ì� ¬ ²·$w œØ ¬ ³ AsyncBufReadÁd‘ t ¬ µ AsyncReadÁLŸ � ¬ ¶ AsyncSeekÁLª © ¬ ·
|
|||
|
|
AsyncWriteÁTµ à ¬ ¸ ReadBufÁ<Á ù ¬ ¹Í4Ê Ý ¬ º (t3 dGDYùü(CëíÚÜL…Á誎�su[]JLÔÉlÖ ä “ ê –
|
|||
|
|
, ë 8 $ì & ð 8¼ ,ñ ö , ÷ 8 methodÁ 4ø & þ 8¼ ,ÿ „ • , … † ’ , ‡ 8À $ˆ & Œ 8¼ ,� $ “ ” *˜ › ‘ 8" 4¥ ¬ ‹ 8 ,º , À 8 $Á Å 8 get_unchecked_mutÁ ŒÆ × Ø Ú � 8 $ì 'ð 8™z $ò ö ø 8· ÷ *ú 8ˆ‚ ý '€ 8ð l‚ � ‘ 8· � ’ , “ 8Ÿü 4” š ¥ , › œ ¢ , � 8À $ž $ £ ¤ $ ¦ 8 $¸ '¼ 8²z ,¾ à Š8½ Ä *Ç 8ˆ‚ Ê 'Í 8ð lÏ Ü Þ 8½ Ý ß , à 8Ÿü 4á ç ò , è é ï , ê 8À $ë $ ð ñ $ ó ü–a � ½ £ ¾ ¿ ¾ ¿ ½ “âƒØ ÜïTÐ ¦ÌƒØ ÜïTë Ïð ¡ ‚Ø“â ”É Íì“â › ‚Ø¦Ì ”ä Íì¦Ì žËáÀÁ ƒØ „Ø Á >@ )+ z| \þ4ƒ ¼ ¼ Üïü”I$— Õ Ö ×„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ÕËá ÖÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ×œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃËá ƒØ ¼ ¦ ¼
|
|||
|
|
Á“â¦ÌÜï$œõײü�O � à £ Ä Ã Ä ¹ƒ ” Ûƒ — �“â L �¦Ì LÔËáÅ ‘ Å ;= @B üå‚Lè Ø Ù Ú Û Ü„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ØËá ÙÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å Ú Ûùù Þú ûÍjö ü filledÁö ý initializedÁö | 8WSm³ú ÜœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
®Ç  … Â
|
|||
|
|
Å“â¦Ì$ûõ×™Íj ·ü£X � Ç £ È Ç È ¹ƒ ¨ Ûƒ « t“â dÙ t¦Ì dîËáÉÊ u v Ê É BD GI ü‚Sl… Ý Þ ß„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ÝËá ÞÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ßœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÝÓË ®Ç Æ � Æ
|
|||
|
|
É“â¦Ì$“õשü’,<• à„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• àËá Æ § Æ
|
|||
|
|
Ê“â¦Ì$� amtÁ ³üõO � Ì £ Í Ì Í ¹ƒ ú Ûƒ ý ©“â L¨ ©¦Ì LºËáÎÏ ª « Ï Î FH KM üËETΠᄾ„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• áËáñLòL óL StartÁ ôLˆ õL öL EndÁ÷Lˆ øL ùL CurrentÁúLˆ aÍ>4¡9cÅ ç‹ Ë ã Ë
|
|||
|
|
Γâ¦Ì$Ù positionÁDïüÐ QlÓ â ã 䄾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• âËá ãÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å äœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
®Ç Ë ë Ë
|
|||
|
|
Ï“â¦Ì$á õ×÷ üÜ R � Ñ £ Ò Ò Ñ ¹ƒ á Ûƒ ä Óâ T� Ã¦Ì T£ ËáÓÔÕÖ× Ä Å Æ Ç Ê Ó × Ö Ô Õ gi ln üµ \T¸ å æ ç 脾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• åËá æÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ç è
|
|||
|
|
æLæL çL IoSliceÁ éLˆ¦ —óë@M$ T ó ®‚ Ð ¤" Ð
|
|||
|
|
Ö“â¦Ì$š"õ׸" bufsÁ$Ö"ü÷##Œú# ô ôËá Ð Œ$ Ð
|
|||
|
|
דâ¦Ì$�$ü®%˜ � Ù £ Ú Ù Ú ¦Ì'F “â 'Ft¶& Ûƒ ¶% 'E“â äô% 'E¦Ì ü™&, ¹ƒ ³%ËáÛÜ 'F 'G Ü LN LÍ&$Ò& Ø Ø Ž¦üç&TLê& õ ö ÷„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• õËá öÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ÷œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙËá 'F Ø þ& Ø
|
|||
|
|
Ü“â¦Ì$ô&õ׊'üò'§ � Þ £ ß › à ¥ á Þ á ß à “âóâ ¥ lÚ( ¦Ìóâ «lŠ) Íìóâ $ý' Íì « ,ƒ(
|
|||
|
|
“âóâ üÁ(' ¹ƒ ÷'
|
|||
|
|
¦Ìóâ üñ(' Ûƒ ú'Ëáâãäåæ
|
|||
|
|
å ã æ ä RT CE ™› •— T ),¥) Ý Ý «ü¹)~T¼) ø ù ú„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• øËá ùÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å úœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ëáóâ Ý Ú) Ý
|
|||
|
|
ã“â¦Ìóâ «$Ð)õ×î)üñ*WTô* û„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ûËáóâί Ý ‰+ Ý
|
|||
|
|
ä“â¦Ìóâ «$ÿ*÷$•+ü„,~T‡, ü ý þ„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• üËá ýÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å þ‰¯ Ý ¥, Ý
|
|||
|
|
å“â¦Ìóâ «$›,õ×¹,ü¼-~T¿- ÿ € �„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ÿËá €Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å �‰¯ Ý Ý- Ý
|
|||
|
|
æ“â¦Ìóâ «$Ó-õ×ñ-‡ªŠªD¾ $ éÿ’ “ – ¹,lq ð —Š.lû � ™¯.tŠ ’ šk<ç Ì� è � ·$ð œØ è ‘ ” tèðñÛû4 ‚Ø é êãß\) ÑÛ é 눂 E „¾ é ìk<[ Ì� é î·$d œØ é ï¤j´ Yt:HTN9;(*[¬ lÌ ¥ ò ò Ëì Ú €ã ÇñËÙzWŒJ ñ ó ×à€ã ö±¬T é ×à€ã ð ð
|
|||
|
|
ñ·µoq tÝ é ð ð ×àüï ! ¥ õ õ Ëì ô €ãö �" ö ”—
|
|||
|
|
$š
|
|||
|
|
‚ ‚€ã ô Ÿ
|
|||
|
|
ô
|
|||
|
|
ö·µ$¤
|
|||
|
|
Ä¥ ¥ ø ø Ëì ª €ãù
|
|||
|
|
üÄ # Ò ·µ€ã ÷ ÷
|
|||
|
|
ù·µ¨,Ö ü™ + — û û Ë� ž —Í4¡ ¾ãüý ƒØ „Ø ý $& \Ë 4Ð ú ú ÅŒüé I$ì ƒ „ …„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ƒ¾ã „Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å …œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã¾ã ƒØ ú û ú
|
|||
|
|
ý�Ü$ñ õׇ
|
|||
|
|
4• ý–• þ ®• þ Ë• þ þ ý þ�Ü ¾ã �Ü dC »’Rt »ï1Œ.ü #ü. DGè�’ƒúL � ÿ �¿úT à ÿ ‚Þú<' ù ÿ ƒ BufÁ > " ÿ … BufMutÁ4C "™ ÿ †’R$Z ¦ ÿ ˆƒ£<` æL ÿ ‰ˆ‚ x „¾ ÿ Š©§,� ¥‚ ÿ Œk<” Ì� ÿ �·$� œØ ÿ ŽLðòßáÎÐ,6¾À©«<PœUŒŽln~L�np\^JLüæ ” ü¥U R Try to read data from an `AsyncRead` into an implementer of the [`BufMut`] trait.Á ûú Ôÿ [`BufMut`]: bytes::BufÁ šú lž
|
|||
|
|
# ExampleÁ ¬ú <°Ó¤ ü¸! use bytes::{Bytes, BytesMut};Á üÚ use tokio_stream as stream;Á Ôú use tokio::io::Result;Á ü•6 3 use tokio_util::io::{StreamReader, poll_read_buf};Á ìÌ use std::future::poll_fn;Á ´ê use std::pin::Pin;Á ü�/ , # #[tokio::main(flavor = "current_thread")]Á ü±. + # async fn main() -> std::io::Result<()> {Á àú üäN K // Create a reader from an iterator. This particular reader will always beÁ l³
|
|||
|
|
// ready.Á üÁh e let mut read = StreamReader::new(stream::iter(vec![Result::Ok(Bytes::from_static(&[0, 1, 2, 3]))]));Á ªú ü®" let mut buf = BytesMut::new();Á ´Ñ let mut reads = 0;Á èú Tì loop {Á œ÷ reads += 1;Á ü‹V S let n = poll_fn(|cx| poll_read_buf(Pin::new(&mut read), cx, &mut buf)).await?;Á âú œæ if n == 0 {Á ”ú break;Á L� }Á ,—Ť �ú ü¡, ) // one or more reads might be necessary.Á ÄÎ assert!(reads >= 1);Á üç( % assert_eq!(&buf[..], &[0, 1, 2, 3]);Á d� # Ok(())Á <� # }Á <¥ Ó¤ lí † ‡ ˆ ‰„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• †·µ ‡Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ˆ ‰èÔ®‚ ¥ � “ ‘ ‘ � ª
|
|||
|
|
ð û ÍìèÔ ’
|
|||
|
|
�·µ Lþ "™èÔ 4•
|
|||
|
|
|
|||
|
|
�·µèÔ’R¢
|
|||
|
|
õ×·
|
|||
|
|
Íj Ñ
|
|||
|
|
[] WY üÜ“ ü¯D A Try to write data from an implementer of the [`Buf`] trait to anÁ üô; 8 [`AsyncWrite`], advancing the buffer's internal cursor.Á °ú ü´M J This function will use [vectored writes] when the [`AsyncWrite`] supportsÁ ¤‚ vectored writes.Á —ú t›÷› ªú ü®G D [`File`] implements [`AsyncWrite`] and [`Cursor<&[u8]>`] implementsÁ dö [`Buf`]:Á ƒú l‡šœ ü•' $ use tokio_util::io::poll_write_buf;Á ”½ use tokio::io;Á ÄÐ use tokio::fs::File;Á éú œí use bytes::Buf;Á ì�’Æ ÄŸ use std::io::Cursor;Á ´¸¸Æ Ïú ”Ó‘� üæ' $ async fn main() -> io::Result<()> {Á üŽ6 3 let mut file = File::create("foo.txt").await?;Á üÅ4 1 let mut buf = Cursor::new(b"data to write");Á úú üþF C // Loop until the entire contents of the buffer are written toÁ ¤Å // the file.Á üÚ# while buf.has_remaining() {Á üþS P poll_fn(|cx| poll_write_buf(Pin::new(&mut file), cx, &mut buf)).await?;Á LÒéË Üú tà Ok(())Á ,ïŤ <õÓ¤ ýú ¼� [`Buf`]: bytes::BufÁ ü™) & [`AsyncWrite`]: tokio::io::AsyncWriteÁ ìà [`File`]: tokio::fs::FileÁ üáA > [vectored writes]: tokio::io::AsyncWrite::poll_write_vectoredÁ tã Š ‹ Œ �„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• Š·µ ‹Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å Œ �èÔ®‚ ¥ “ “ ” “ ” Ÿ ð ò ûÐ Š ÷µ Tõ "èÔ �
|
|||
|
|
’·µèÔ’R—õ׬Íj ÆQS VX ¬öDüÿ D° ’ ’ ìa¡D𕘉ŒtÉ ü R O An extension trait for Futures that provides a variety of convenient adapters.Á 4Ñ œ¿Ô{Ü� — › »ª~ü¬ À › ¼Ûû4á ‚Ø › ½ÉŒû H › ¾ ‡ÜT ¼X›— À › à Ûû4 ‚Ø œ žˆ‚ ( „¾ œ Ÿk<8 Ì� œ ¡·$A œØ œ ¢×ü\b œ £ÉŒ‚ H œ ¥ ‡èq¼• ‡ œ ¦ ‹ätä® ´ œ § Œ t¶D#¥ü1—™†ˆìPw\thjTV?Aü¨6 Þ © — ª ª © Âß ± Óß4´Æä« üåO ó µ‚†ÍÆä ¨ ¨
|
|||
|
|
« ކ͆”÷ý.4¢¢ «–• ¬ ®• ¬ Ë• ¬ ¬ « ¬ †Í ‡ ‡ èq Š —r ‹ ý. L‚@Ó°ÍÜë †Í ÓŒ†ÍüóA Þ ® — ¯ ® ¯ Âß ü Óß4ÿÆä°± ƒØ „Ø ± ø*, \» 4À Èáüá I$ä Ž � �„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ŽÆä �Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å �œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÆä ƒØ ó
|
|||
|
|
± Þ†Í$é õ×ÿ üÃ3 — ³ ³ Ë� È —Í4ËÖå´ üýK ‹ ÙÖ�ÜÖå ² ²
|
|||
|
|
´�܆”�ý.4¶¶ ´–• µ ®• µ Ë• µ µ ´ µ�Ü ÕÛ µ£üŒ> — · · Ë� ‘ —Í4”Ö帹 ƒØ „Ø ¹ $& \Ñ4Ö ¶ ¶ €Œü÷I$ú ‘ ’ “„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ‘Öå ’Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å “œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖå ƒØ ¶ ‰ ¶
|
|||
|
|
¹�Ü$ÿõו¼uqtbeœÔUôîFÜè ü�X U A trait which contains a variety of convenient adapters and utilities for `Future`s.Á Lò ¿ ¿ Îì üè¶ ‚Ø
|
|||
|
|
Ï°
|
|||
|
|
É \Û ç ¸ ñ € , ò ó þ , ô 8÷ $õ & ù 8÷ $ú
|
|||
|
|
ÿ *‚ … ² , “ ” § + ¦ § À 8â ¨ « ¿ 8» <¬ ´ 7‰ L¶ + Ò Ó ƒ 8ä DÔ Ü ‚ 8áå 4Ý $ ã 8Ó å è � 8â é ì € 8» <í õ 7‰ L÷ , • 8÷ $–
|
|||
|
|
¨ \ç »ï1ˆ PÈ J <ë ” ,
|
|||
|
|
z % , # , 8 argÁ & 8¯ !
|
|||
|
|
$ *' * w + 4 5 N 8â 6 9 M 8» <: B 7Ô1 LD 8Ô1 <X '_ 8ã1 ,a f g p , h i n , j 8ø‚ k
|
|||
|
|
o % q % x lù ü 9 6 Adaptors from `AsyncRead`/`AsyncWrite` to Stream/SinkÁ :ú ü>K H Raw I/O objects work with byte sequences, but higher-level code usuallyÁ üŠA > wants to batch these into meaningful chunks, called "frames".Á Ìú üÐP M This module contains adapters to go from streams of bytes, [`AsyncRead`] andÁ ü¡K H [`AsyncWrite`], to framed streams implementing [`Sink`] and [`Stream`].Á üí0 - Framed streams are also known as transports.Á žú ü¢) & # Example encoding using `LinesCodec`Á Ìú üÐS P The following example demonstrates how to use a codec such as [`LinesCodec`] toÁ ü¤P M write framed data. [`FramedWrite`] can be used to achieve this. Data sent toÁ üõT Q [`FramedWrite`] are first framed according to a specific codec, and then sent toÁ üÊ% " an implementor of [`AsyncWrite`].Á ðú <ôÓ¤ üü use futures::sink::SinkExt;Á üœ& # use tokio_util::codec::LinesCodec;Á üÃ' $ use tokio_util::codec::FramedWrite;Á ëú üï/ØÆ ¼Ÿ # async fn main() {Á ä· let buffer = Vec::new();Á üÔ* ' let messages = vec!["Hello", "World"];Á üÿ$ ! let encoder = LinesCodec::new();Á ¤ú ü¨D A // FramedWrite is a sink which means you can send values into itÁ ´í // asynchronously.Á ü„ 7 4 let mut writer = FramedWrite::new(buffer, encoder);Á ¼ ú üÀ J G // To be able to send values into a FramedWrite, you need to bring theÁ ü‹
|
|||
|
|
" // `SinkExt` trait into scope.Á ü®
|
|||
|
|
, ) writer.send(messages[0]).await.unwrap();Á üÛ
|
|||
|
|
, ) writer.send(messages[1]).await.unwrap();Á ˆ ú üŒ " let buffer = writer.get_ref();Á ¯ ú ü³ ? < assert_eq!(buffer.as_slice(), "Hello\nWorld\n".as_bytes());Á <ó ²Í 4û ```Á ‚ ú ü† ) & # Example decoding using `LinesCodec`Á ü° S„‰ ü„
|
|||
|
|
\ Y read a stream of framed data. [`FramedRead`] can be used to achieve this. [`FramedRead`]Á üá
|
|||
|
|
b _ will keep reading from an [`AsyncRead`] implementor until a whole frame, according to a codec,Á ”Ä can be parsed.Á ×ú 4Û÷’ üâ use tokio_stream::StreamExt;Á üƒ&ŠŒ üª& # use tokio_util::codec::FramedRead;Á Ñú üÕ/ØÆ ¼…„� ü�, ) let message = "Hello\nWorld".as_bytes();Á üÊ$ ! let decoder = LinesCodec::new();Á ïú üóU R // FramedRead can be used to read a stream of values that are framed according toÁ üÉW T // a codec. FramedRead will read from its input (here `buffer`) until a whole frameÁ ¬¡ // can be parsed.Á ü·7 4 let mut reader = FramedRead::new(message, decoder);Á ïú üó> ; // To read values from a FramedRead, you need to bring theÁ ü²$ ! // `StreamExt` trait into scope.Á ü×7 4 let frame1 = reader.next().await.unwrap().unwrap();Á ü�7 4 let frame2 = reader.next().await.unwrap().unwrap();Á Çú üË+ ( assert!(reader.next().await.is_none());Á ü÷ assert_eq!(frame1, "Hello");Á ü˜ assert_eq!(frame2, "World");Á <¹²Í <ÁÓ¤ Éú ¼Í # The Decoder traitÁ åú üéO L A [`Decoder`] is used together with [`FramedRead`] or [`Framed`] to turn anÁ ü¹O L [`AsyncRead`] into a [`Stream`]. The job of the decoder trait is to specifyÁ ü‰G D how sequences of bytes are turned into a sequence of frames, and toÁ üÑF C determine where the boundaries between frames are. The job of theÁ ü˜N K `FramedRead` is to repeatedly switch between reading more data from the IOÁ üçL I resource, and asking the decoder whether we have received enough data toÁ ü´! decode another frame of data.Á Öú üÚP M The main method on the `Decoder` trait is the [`decode`] method. This methodÁ ü«P M takes as argument the data that has been read so far, and when it is called,Á üü2 / it will be in one of the following situations:Á ¯ú ü³3 0 1. The buffer contains less than a full frame.Á üç1 . 2. The buffer contains exactly a full frame.Á ü™ 3 0 3. The buffer contains more than a full frame.Á Í ú üÑ A > In the first situation, the decoder should return `Ok(None)`.Á “ ú ü— M J In the second situation, the decoder should clear the provided buffer andÁ üå ) & return `Ok(Some(the_decoded_frame))`.Á � ú ü“ P M In the third situation, the decoder should use a method such as [`split_to`]Á üä O L or [`advance`] to modify the buffer such that the frame is removed from theÁ ü´ N K buffer, but any data in the buffer after that frame should still remain inÁ üƒ O L the buffer. The decoder should also return `Ok(Some(the_decoded_frame))` inÁ tÓ this case.Á â ú üæ O L Finally the decoder may return an error if the data is invalid in some way.Á ü¶!O L The decoder should _not_ return an error just because it has yet to receiveÁ Œ†" a full frame.Á ˜"ú üœ"M J It is guaranteed that, from one call to `decode` to another, the providedÁ üê"O L buffer will contain the exact same data as before, except that if more dataÁ üº#M J has arrived through the IO resource, that data will have been appended toÁ üˆ$F C the buffer. This means that reading frames from a `FramedRead` isÁ üÏ$1 . essentially equivalent to the following loop:Á �%ú l…%šœ ü“% use tokio::io::AsyncReadExt;Á ü´%C @ # // This uses async_stream to create an example that compiles.Á üø%r o # fn foo() -> impl futures_core::Stream<Item = std::io::Result<bytes::BytesMut>> { async_str
|
|||
|
|
á±Ñ Ôë
|
|||
|
|
ü©
|
|||
|
|
= : Creates a new `BytesCodec` for shipping around raw bytes.Á ò
|
|||
|
|
á± Ð Ð
|
|||
|
|
Ñ Ü¨ á±ÓÔÕ å æ ç Õ LÊ $Ï Ò Ò Ž´Tä ,é Ò Ò ®Çü� O 4„ • – •á± –Ž´Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙŽ´®Ç Ò ‹ Ò
|
|||
|
|
Õ $� Íj – üò
|
|||
|
|
" á±×Ø ñ ò Ø T› , Ö Ö ®Çü¸N 4» — ˜ —á±¢³ ˜Ž´ç‹ Ö Â Ö
|
|||
|
|
Ø $Ç Ò²$Í Íj Ú üÙ% á±ÚÛ ñ ò Û T… ,Š Ù Ù ®Çü¢Q 4¥ ™ š ™á±Ž´ šŽ´ç‹ Ù ¬ Ù
|
|||
|
|
Û $± Ò²$· Íj Ç ì‰cU\©c <cÇäÒ’4 � Ý Þ ùƒúL+ � Ý à¿úT6 Ã Ý á˜³DO "¿ Ý â’Rb ¦ Ý ã¤kL WYFH|H8<])Œâ
|
|||
|
|
üg# Decoding of frames via buffers.Á ‹ú ü�E B This trait is used when constructing an instance of [`Framed`] orÁ üÕO L [`FramedRead`]. An implementation of `Decoder` takes a byte stream that hasÁ ü¥H E already been buffered in `src` and decodes the data into a stream ofÁ Äî `Self::Item` frames.Á ‡ú ü‹D A Implementations are able to track state on `self`, which enablesÁ üÐM J implementing stateful streaming parsers. In many cases, though, this typeÁ üž= : will simply be a unit struct (e.g. `struct HttpDecoder`).Á Üú üà= : For some underlying data-sources, namely files and FIFOs,Á üž> ; it's possible to temporarily read 0 bytes by reaching EOF.Á Ýú üá? < In these cases `decode_eof` will be called until it signalsÁ ü¡> ; fulfillment of all closing frames by returning `Ok(None)`.Á üàO L After that, repeated attempts to read from the [`Framed`] or [`FramedRead`]Á ü°J G will not invoke `decode` or `decode_eof` again, until data can be readÁ œû during a retry.Á �ú ü“D A It is up to the Decoder to keep track of a restart after an EOF,Á üØ> ; and to decide how to handle such an event by, for example,Á ü— K H allowing frames to cross EOF boundaries, re-emitting opening frames, orÁ üã ( % resetting the entire internal state.Á Œ
|
|||
|
|
ú ü�
|
|||
|
|
$ ! [`Framed`]: crate::codec::FramedÁ üµ
|
|||
|
|
, ) [`FramedRead`]: crate::codec::FramedReadÁ <ì
|
|||
|
|
ä ä µñüâ
|
|||
|
|
º4 ä µñ µñ åæçèéåæçèé Íì½ñ å Tž Ë� Íì½ñ æ ä é ò�®Ç |¬ ê� ‚‘ ç è é Lž üú
|
|||
|
|
The type of decoded frames.Á$£ ä ä Ü ü® 4 1 The type of unrecoverable frame decoding errors.Á ç ú üï E B If an individual message is ill-formed but can be ignored withoutÁ ü¹ F C interfering with the processing of future messages, it may be moreÁ ü„
|
|||
|
|
. + useful to report the failure as an `Item`.Á ·
|
|||
|
|
ú ü¿
|
|||
|
|
L I `From<io::Error>` is required in the interest of making `Error` suitableÁ ü�K H for returning directly from a [`FramedRead`], and to enable the defaultÁ üàK H implementation of `decode_eof` to yield an `io::Error` when the decoderÁ ü°( % fails to consume all available data.Á Ýú üåJ G Note that implementors of this trait can simply indicate `type Error =Á ü´. + io::Error` to use I/O errors as this type.Á çú üï,ÇŽ,¥ ä ä üŸ(T üÂA > Attempts to decode a frame from the provided buffer of bytes.Á ˆú ü�J G This method is called by [`FramedRead`] whenever bytes are ready to beÁ üßH E parsed. The provided buffer of bytes is what's been read so far, andÁ ü¬I F this instance of `Decode` can determine whether an entire frame is inÁ üú+ ( the buffer and is ready to be returned.Á ªú ü²I F If an entire frame is available, then this instance will remove thoseÁ ü€? < bytes from the buffer provided and return them as a decodedÁ üÄK H frame. Note that removing bytes from the provided buffer doesn't alwaysÁ ü”K H necessarily copy the bytes, so this should be an efficient operation inÁ ¼ä most circumstances.Á €ú üˆH E If the bytes look valid, but a frame isn't fully available yet, thenÁ üÕJ G `Ok(None)` is returned. This indicates to the [`Framed`] instance thatÁ ü¤F C it needs to read some more bytes before calling this method again.Á ïú ü÷D A Note that the bytes provided may be empty. If a previous call toÁ üÀG D `decode` consumed all the bytes in the buffer then `decode` will beÁ üŒP M called again until it returns `Ok(None)`, indicating that more bytes need toÁ dá be read.Á òú üúF C Finally, if the bytes in the buffer are malformed then an error isÁ üÅK H returned indicating why. This informs [`Framed`] that the stream is nowÁ ü• % " corrupt and should be terminated.Á ¿ ú üÇ $™Ž üð ,ÇŽ ¡ ú ¼© # Buffer managementÁ Å ú üÍ J G Before returning from the function, implementations should ensure thatÁ üœ J G the buffer has appropriate capacity in anticipation of future calls toÁ üë 5 2 `decode`. Failing to do so leads to inefficiency.Á ¥ ú ü G D For example, if frames have a fixed length, or if the length of theÁ üù F C current frame is known from a header, a possible buffer managementÁ „Ä
|
|||
|
|
strategy is:Á Ù ú lá šœ ”ó # use std::io;Á ,Š! #Á Ô”! # use bytes::BytesMut;Á ü³!%± ,Ý!ܧ ¬ç! # struct MyCodec;Á ,�"ܧ ô‹" impl Decoder for MyCodec {Á t®" // ...Á üÁ" # type Item = BytesMut;Á üå"! # type Error = io::Error;Á ‹#ú ü“#] Z fn decode(&mut self, src: &mut BytesMut) -> Result<Option<Self::Item>, Self::Error> {Á ”õ# // ...Á Œ$ú ü”$H E // Reserve enough to complete decoding of the current frame.Á üá$< 9 let current_frame_len: usize = 1000; // Example.Á ü¢%4 1 // And to start decoding the next frame.Á üÛ%> ; let next_frame_header_len: usize = 10; // Example.Á üž&C @ src.reserve(current_frame_len + next_frame_header_len);Á æ&ú äî& return Ok(None);Á L�'éË ,�'Ť <§'Ó¤ ³'ú ü»'E B An optimal buffer management strategy minimizes reallocations andÁ ¬…( over-allocations.Á4¢( › œ ›½ñ œŽ´Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ô ü×ü\Ï ô ýY4î ô ÿZLö £ ô €’R‹ ¦ ô �ˆ‚ � „¾ ô ‚©§,² ¥‚ ô „k<¹ Ì� ô …·$ œØ ô †ô>ô(0¤M!Lg|�ù”¥éì½Ú\àÌμ¾<†¯l“ŸL¦Ž�|~jlì‘„—ô äí Tÿ 㷠ƸðÐzo¡C ‰ŠÜ�4› ˆ ˆ Ž´ü±'¬¼ ˆ ˆ ÔÒ Ä¶Œ ´ Œ ¤ó<ö Ķ ‹ ‹
|
|||
|
|
Œ Üà 㷎 ´ Ž ¤å <è ã· � �
|
|||
|
|
Ž ü’ ! Ķ� ë � üº %$½ Ž´Ä¶ � �
|
|||
|
|
� ô54Æ üþ
|
|||
|
|
" ã·’ ë ’ ü§%$ª Ž´ã· ‘ ‘
|
|||
|
|
’ ô54³üÅ# ™·” ¢ ” ôï4ò ¡ ¡™· ¡Ä¶ “ ù “
|
|||
|
|
” $úü«& ™·– ¥ – üØ*TÛ ¢ ¢™· ¢Ä¶ • æ •
|
|||
|
|
– $ëü¤$ ™·˜ ¢ ˜ üÏ 4Ò £ £™· £ã· — Ù —
|
|||
|
|
˜ $Úü�' ™·š ¥ š ü»+T¾ ¤ ¤™· ¤ã· ™ É ™
|
|||
|
|
š $Îü‰q ¥ œ ¦ � £ ž � ž œ Ëì Ž ¾ð ‘ Íìǹ ” ŒÑLà 併 <Õ £Ç¹Ä¶ ¤åû¸Ÿ 'F 'G ]_ bd ^` L�$† › › Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
½µ å½µ æüTL° ¥ ¦ §„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ¥û¸ ¦Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å §œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙû¸ 'F › Ä ›
|
|||
|
|
·µ½µÇ¹$ºõ×ÐÔ�l�,”@ –• ¢ ®• ¢ Ë• ¢ ¢ ¢·µ½µÇ¹ �Þ�Þ $”E –• £ ®• £ Ë• £ £ £·µ½µÇ¹¼âËâ,¤L –• ¤ ®• ¤ Ë• ¤ ¤ ¤·µ½µÇ¹ ®Ç®Ç Ëâü¡U™ ¥ ¦ š § ¦ ¨ ¨ © § ¨ ¦ © Ëì ¦U Í쥺 ©U Í웶 ¬U Í쟺 ¯U ›ßTßU ¥º TòU é ›¶¥º ñ®Ç |ŒV £Ÿºã· ¬¤VÓ¹ª«¬¯
|
|||
|
|
¬ ¯ « ¸º ´¶ °² ¬® TÁV,ÆV ¥ ¥ ÙåüÝV^TàV ¨ © ª„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ¨Ó¹ ©Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ªœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ó¹¥º ¥ ùV ¥
|
|||
|
|
«·µ¥º›¶Ÿº$ïVõ×…WüˆYGT‹Y «„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• «Ó¹¥º¹é ¥ Y ¥
|
|||
|
|
¬·µ¥º›¶Ÿº$–Y÷$¬YüöZZTùZ ¬ ®„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ¬Ó¹ Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ®ôè ¥ Ž[ ¥
|
|||
|
|
·µ¥º›¶Ÿº$„[õך[Üß[tì[ü£b^T¦b ¯ ° ±„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ¯Ó¹ °Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ±ôè ¥ ¿b ¥
|
|||
|
|
¯·µ¥º›¶Ÿº$µbõ×ËbŒ¾d
|
|||
|
|
<
|
|||
|
|
<ü;ÿ;î;ñ;à;ã;T�e 4…eǪ�…Ä3< ä µ ¶±4<? ï µ ·“•Th ª µ ¹ºQDt ¥ µ ºãPL~ ž µ »â5T‰ ˆ µ ¼Ó¦4© 'E µ ½ƒúLÁ � µ ¿¿úTÌ Ã µ À˜³Då "¿ µ Á¼é$�
|
|||
|
|
µ Â×ü\� µ Ã× ³ ¤, µ Ä’RÁ ¦ µ ň‚ Ó „¾ µ Æk<è Ì� µ È·$ñ œØ µ Éô hô( ZÌL KN=@/2!$¤› Lµ
|
|||
|
|
÷ù|Þ é”ó Ùì‹ ÊD® »<¼ ¬lÉ œLÜ ��{}¼—
|
|||
|
|
¥ Ë ¦ Ì Ì Ë Ëì œ
|
|||
|
|
¾ð Ÿ
|
|||
|
|
üºÍÎÏÐÑÒÓÔÕØÙÚÛÜÝÞßà FH KM ü�. üµ
|
|||
|
|
P Ï» üŠQ N I/O object, using [`Decoder`] and [`Encoder`] to read and write the raw data.Á à ú üèK ¤… ü¸F ™½ üƒE B method layers framing on top of an I/O object, by using the codecÁ üÍH º¾ üš: Œ¿ Ù ú üáG D This function returns a *single* object that is both [`Stream`] andÁ üM J [`Sink`]; grouping this into a single object is often useful for layeringÁ üÿL €Á ´Ð ÕÁ ë ú üóI � üÁI F calling [`split`] on the `Framed` returned by this method, which willÁ ü�L §Ã à ú üèL I Note that, for some byte sources, the stream can be resumed after an EOFÁ ü¹L I by reading from it, even after it has returned `None`. Repeated attemptsÁ üŠK H to do so, without new data available, continue to return `None` withoutÁ üÚ# creating more (closing) frames.Á ‚ ú üŠ$ šñ ü³ Èñ üØ% " [`Decode`]: crate::codec::DecoderÁ ü‚& # [`Encoder`]: crate::codec::EncoderÁ ü[ X [`split`]: https://docs.rs/futures/0.3/futures/stream/trait.StreamExt.html#method.splitÁ ” ·µ½µüº Ê Ê
|
|||
|
|
Í·µ½µ¨,˜ ï1,¢ üØ&I üìP Ï» üÁ Q N I/O object, using [`Decoder`] and [`Encoder`] to read and write the raw data,Á ü— 1 . with a specific read buffer initial capacity.Á Í ú üÕ K ¤… ü¥ F ™½ üð E �ö üº H º¾ ü‡ : Œ¿ Æ ú üÎ G „÷ üš!M Õ÷ üì!L €Á ´½" ÕÁ Ø" ú üà"I � ü®#I áø üü#L §Ã Í$ ú üÕ$$ šñ üþ$ Èñ ü£%% ¤ü üÍ%& Óü üø%[ ƒýlß& ·µ½µ üº Ê Ê
|
|||
|
|
ηµ½µ¨,í& ï1,÷& ‘ƒD�' ü¹8; ü“,P Ï» üè,Q Šõ ¾- ú üÆ-K ¤… ü–.F ™½ üá.G é½ ü/H º¾ üú/: Œ¿ ¹0 ú üÁ0G „÷ ü�1M Õ÷ üß1L €Á ´°2 ÕÁ Ë2 ú üÓ2S P This objects takes a stream and a `readbuffer` and a `writebuffer`. These fieldÁ ü«3M J can be obtained from an existing `Framed` with the [`into_parts`] method.Á ý3 ú ü…4I � üÓ4I áø ü¡5L §Ã ò5 ú üú5$ šñ ü£6 Èñ üÈ6& # [`Decoder`]: crate::codec::DecoderÁ üó6& Óü üž76 3 [`into_parts`]: crate::codec::Framed::into_parts()Á üÙ7[ ƒýTÀ8 �¼üº Ê Ê
|
|||
|
|
Ï·µ½µ partsÁ,Ë8 ܾ= üª;? < Returns a reference to the underlying I/O stream wrapped byÁ lî;
|
|||
|
|
`Framed`.Á €< ú üˆ<K H Note that care should be taken to not tamper with the underlying streamÁ üØ<F C of data coming in as it may corrupt the stream of frames otherwiseÁ ´£= being worked with.Á<Å= ² ²üº ²·µ Ê Í= Ê
|
|||
|
|
зµ½µ$Î= ü�@# ü�>G D Returns a mutable reference to the underlying I/O stream wrapped byÁ lÍ> ؈ ß> ú üç>K ûˆ ü·?F Љ ´‚@ ŸŠ<¤@ ³ ³üº ³·µ Ê ¬@ Ê
|
|||
|
|
Ñ·µ½µ$±@ ü�C7 üì@N K Returns a pinned mutable reference to the underlying I/O stream wrapped byÁ l¿A ؈ ÑA ú üÙAK ûˆ ü©BF Љ ´ôB ŸŠ\–C ´„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ´üº„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ´·µ Ê ¬C Ê
|
|||
|
|
Ò·µ½µ$¢C ÌõE ü�D: 7 Returns a reference to the underlying codec wrapped byÁ lÀD ؈ ÒD ú üÚDJ G Note that care should be taken to not tamper with the underlying codecÁ ü©EG D as it may corrupt the stream of frames otherwise being worked with.Á,üE µ µüº µ½µ Ê ‚F Ê
|
|||
|
|
Ó·µ½µ$ƒF ü²H% ü¶FB ? Returns a mutable reference to the underlying codec wrapped byÁ lýF ؈ �G ú ü—GJ ç� üæGG »‘L¹H ¶ ¶üº ¶½µ Ê ÃH Ê
|
|||
|
|
Ô·µ½µ$ÈH üŒKY üƒID A Maps the codec `U` to `C`, preserving the read and write buffersÁ ÄÌI wrapped by `Framed`.Á éI ú üñIJ ç� üÀJG »‘L“K üº‰ï � � Ò’ „¨ µ çwpW…r}X·µ” Ê” Ö — × Ö × Ê Íì— �K àð K –"‰ï½µ tÖK ‰ï›˜˜" — ãK
|
|||
|
|
Õ·µ½µÂ—‰ï$£K Ø ©K ]_ bd üÈP4 üÌNB õ’ l“O ؈ ¥O ú üOJ ç� üüOG »‘lÏP ·„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ·üº ·½µ Ê çP Ê
|
|||
|
|
Ø·µ½µ$ÝP üçQ& ü·Q+ ( Returns a reference to the read buffer.Á\îQ ¸ ¸üº ¸Ž´ Ê úQ Ê
|
|||
|
|
Ù·µ½µ$ûQ üùR2 üÁR3 0 Returns a mutable reference to the read buffer.Á|€S ¹ ¹üº ¹Ž´ Ê �S Ê
|
|||
|
|
Ú·µ½µ$•S ü”T' üãS, ) Returns a reference to the write buffer.Ád›T º ºüº ºŽ´ Ê ¨T Ê
|
|||
|
|
Û·µ½µ$©T ü©U3 üðT4 1 Returns a mutable reference to the write buffer.Á„°U » »üº »Ž´ Ê ÁU Ê
|
|||
|
|
Ü·µ½µ$ÆU ü»V, ü•V! Returns backpressure boundaryÁ¬ÂV ¼ ¼üº Ê ØV Ê
|
|||
|
|
Ý·µ½µ$ÙV üÐW< üªW! Updates backpressure boundaryÁÌ×W ½ ½üº Ê ñW Ê
|
|||
|
|
Þ·µ½µ$öW boundaryÁDüW äÝZ üÛX? < Consumes the `Framed`, returning its underlying I/O stream.Á ŸY ú ü§YK ûˆ ü÷YF Љ ´ÂZ ŸŠTäZ üº·µ Ê Ê
|
|||
|
|
ß·µ½µ$ïZ üÛ], ü [J G Consumes the `Framed`, returning its underlying I/O stream, the bufferÁ üï[) & with unprocessed data, and the codec.Á �\ ú ü¥\K ûˆ üõ\F Љ ´À] ŸŠTâ] üº�¼ Ê Ê
|
|||
|
|
à·µ½µ$í] ü±`J ¥ â ¦ ã â ã Ëì ¶` ¾ð ¹` ŒÑLá` ÂÜ<ó` üºäå 'F 'G å 02 57 L‚a $‡a á á ·Ýü®aT L±a ¾ ¿ À„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ¾üº ¿Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ÀœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãۼݼ޼© ß¼ à¼ÛἈ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
Íå§ ï i ï
|
|||
|
|
ò·µ½µ$¡i ± §i äðp ¥ ô ¦ õ ô õ Ëì õp ¾ð øp �¼ö üÀqT ü“q( % Create a new, default, `FramedParts`Á Çq ·µ½µ�¼ óš ÷ ÷ ó Íìš Ëq ï½µÕ¹ T‰r
|
|||
|
|
ö·µ½µÕ¹’RÎq ï1,Õq 9; d•e�`„`u`x`|»e \¿eÇØÜ“•T ª û ýãPL, ž û þÄ3<J ä û ÿ ëÓ¦4f 'E û €ƒúL} � û �˜³D” "¿ û ‚¼é$°
|
|||
|
|
û ƒ×ü\Ì û „× â ¤, û …ˆ‚ õ „¾ û †k<Š Ì� û ˆ·$“ œØ û ‰ïQ\¦ ª û Š úÌ ¬< ¤X î¤r ß|� Д¢ Àìº ±DÝ ¢lë ’Lþ ƒ…qs”Ÿ cÜì ¥ Œ • � Œ � Ëì ñ Íìï½ ô ¼½Ž��‘’“”•–™š›œ @B <> üË 4 üŽ 8 5 Creates a new `FramedRead` with the given `decoder`.Á Ò ·µï½¼½ ‹ ‹
|
|||
|
|
Ž·µï½¨,Ö —3<à üª O ü½ R O Creates a new `FramedRead` with the given `decoder` and a buffer of `capacity`Á Œ” initial size.Ál± ·µï½ ¼½ ‹ ‹
|
|||
|
|
�·µï½¨,¿ —3<É ‘ƒDÕ Ü‰ üñ? �ˆ Œµ `FramedRead`.Á Ë ú üÓK ûˆ ü£F Љ ´î ŸŠ<� Πμ½ ηµ ‹ ˜ ‹
|
|||
|
|
�·µï½$™ üì# üÌG ¨‹ Œ˜ ÅÀ ® ú ü¶K ûˆ ü†F Љ ´Ñ ŸŠ<ó Ï Ï¼½ Ï·µ ‹ û ‹
|
|||
|
|
‘·µï½$€ üâ7 ü»N ¤� ŒŽ ÅÀ ¤ ú ü¬K ûˆ üüF Љ ´Ç ŸŠ\é Є¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• м½„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• зµ ‹ ÿ ‹
|
|||
|
|
’·µï½$õ äÚ üÔC @ Consumes the `FramedRead`, returning its underlying I/O stream.Á œ ú ü¤K ûˆ üôF Љ ´¿ ŸŠTá ¼½·µ ‹ ‹
|
|||
|
|
“·µï½$ì ÜÔ ü�2 / Returns a reference to the underlying decoder.Á<Û Ñ Ñ¼½ Ñï½ ‹ ã ‹
|
|||
|
|
”·µï½$ä üÖ ' ü— : 7 Returns a mutable reference to the underlying decoder.Á\Ý Ò Ò¼½ Òï½ ‹ é ‹
|
|||
|
|
•·µï½$î ü† _ ü© ; 8 Maps the decoder `D` to `C`, preserving the read bufferÁ Äé ¬•\� ¼½‰ï Ø Ø �� Û¨ û ›F}pøc·µÂ— ‹” — — ˜ — ˜ ‹ ÷— ™ àð œ –"‰ïï½ tÖ ‰ïÞ̘" — ã
|
|||
|
|
–·µï½Â—‰ï$Ÿ Ø ¥ ]_ bd ü•"6 üÖ!: ÅÈ|œ" Ó„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• Ó¼½ Óï½ ‹ ¶" ‹
|
|||
|
|
™·µï½$¬" ü¶#& ü†#+ è™\½# Ô Ô¼½ ÔŽ´ ‹ É# ‹
|
|||
|
|
š·µï½$Ê# üÃ$2 ü‹$3 †›|Ê$ Õ Õ¼½ ÕŽ´ ‹ Ú$ ‹
|
|||
|
|
›·µï½$ß$ ü©&, ü¨%N K Consumes the `FramedRead`, returning its underlying I/O stream, the bufferÁ üû%) ³£T°& ¼½ ª ª ïQ ’R ®ï1 ¯¤R °´R ±³E { ä�áT·µï½ ‹ ‹
|
|||
|
|
œ·µï½$»& üì(N ¥ ž • Ÿ Ÿ ž Ëì ñ( á½ ô( ŒÑL ) äï½ <²) ¼½ ¡ 'F 'G ¡ 8: =? LÁ) $Æ) � � Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ï½ åï½ æüí)T Lð) Ö × Ø„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• Ö¼½ ×Ì�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ØœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ¼½ 'F � „* �
|
|||
|
|
¡·µï½$ú) õ×�* ü«+@ ¥ £ š ¤ • ¥ £ ¤ ¥ Ëì °+ ƒå ³+ Í줽 ¶+
|
|||
|
|
·µ¥º <ã+ …¾¦§¨©ª
|
|||
|
|
¨ © § ª bd gi ce Tò+ ,÷+ ¢ ¢ ·µ¥º üŽ,Z T‘, Ù Ú Û„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• Ù…¾ ÚÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ÛœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
…¾¥º ¢ ¦, ¢
|
|||
|
|
§·µ¥º¤½$œ, õײ, ü²-G Tµ- Ü„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• Ü…¾¥º¬Ü ¢ Ê- ¢
|
|||
|
|
¨·µ¥º¤½$À- ÷$Ö- üÅ.Z TÈ. Ý Þ ß„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• Ý…¾ ÞÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å ßçÛ ¢ Ý. ¢
|
|||
|
|
©·µ¥º¤½$Ó. õ×é. üé/Z Tì/ à á ℾ„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• à…¾ áÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å âçÛ ¢ �0 ¢
|
|||
|
|
ª·µ¥º¤½$÷/ õ×�0 ü‹1V ¥ ¬ • ¬ Ëì �1 á½ “1 ÊñTÃ1 ¿cï½ TÖ1 ¼½® Àc ® 35 8: üè18 ë1 ã ä å ã¼½ ä c c ˆ ¢cµ
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
åå§ « ï1 «
|
|||
|
|
®·µï½$ð1 ± ö1 ìÔe'v„ôe døeǯ³±4< ï ° ±“•TD ª ° ³â5TP ˆ ° ´Ó¦4p 'E ° µ¿úT‡ à ° ¶˜³DŸ "¿ ° ·¼é$»
|
|||
|
|
° ¸×ü\× ° ¹× í ¤, ° º’Rû ¦ ° »ˆ‚ � „¾ ° ¼k<¢ Ì� ° ¾·$« œØ ° ¿ïQ\¾ ª ° À úô -Ì( !¤b ¬| ö|˜ æ” ÖìÅ ÇDè ¸<ö ©lƒ ™L– ŠŒxz”· jä» ¥  – à à  Ëì À ÍìÑ¿ à ž¿ÄÅÆÇÈÉÊËÌÏÐÑÒÓÔ FH BD üœ 5 üÞ9 6 Creates a new `FramedWrite` with the given `encoder`.Á £ ·µÑ¿ž¿ Á Á
|
|||
|
|
Ä·µÑ¿¨,§ ˜4<± ü� P ü“ S P Creates a new `FramedWrite` with the given `encoder` and a buffer of `capacity`Á Œë »¿lˆ ·µÑ¿ ž¿ Á Á
|
|||
|
|
Å·µÑ¿¨,– ˜4< ‘ƒD¬ Ü© ü�? �ˆ ”Ô `FramedWrite`.Á ë ú üóK ûˆ üÃF Љ ´Ž ŸŠ<° æ æž¿ æ·µ Á ¸ Á
|
|||
|
|
Æ·µÑ¿$¹ ü�# üìG ¨‹ ”¸ ›ì Ï ú ü×K ûˆ ü§F Љ ´ò ŸŠ<” ç çž¿ ç·µ Á œ Á
|
|||
|
|
Ç·µÑ¿$¡ ü„7 üÜN ¤� ”¯ ›ì Æ ú üÎK ûˆ üžF Љ ´é ŸŠ\‹ 脾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• èž¿„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• è·µ Á ¡ Á
|
|||
|
|
È·µÑ¿$— äý üöD A Consumes the `FramedWrite`, returning its underlying I/O stream.Á ¿ ú üÇK ûˆ ü—F Љ ´â ŸŠT„ ž¿·µ Á Á
|
|||
|
|
É·µÑ¿$� Ü÷ üÀ2 / Returns a reference to the underlying encoder.Á<þ é éž¿ éÑ¿ Á † Á
|
|||
|
|
Ê·µÑ¿$‡ üù' üº: 7 Returns a mutable reference to the underlying encoder.Á\€ ê êž¿ êÑ¿ Á Œ Á
|
|||
|
|
Ë·µÑ¿$‘ üª ` üÌ < 9 Maps the encoder `E` to `C`, preserving the write bufferÁ Ä� ¬•\± ž¿‰ï ¯ ¯ Ç� ²¨ ° Ír°k0Fo·µÂ— Á” Í — Î Î Í Á ÷— ½ àð À –"‰ïÑ¿ tû ‰ï·ø˜" — ˆ
|
|||
|
|
Ì·µÑ¿Â—‰ï$Ã Ø É ]_ bd ü»!6 üü : �ô|Â! 넾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ëž¿ ëÑ¿ Á Ü! Á
|
|||
|
|
Ï·µÑ¿$Ò! üÝ"' ü¬", ¬œdä" ì ìž¿ 쎴 Á ñ" Á
|
|||
|
|
зµÑ¿$ò" üì#3 ü³#4 Ë�„ó# í íž¿ 펴 Á „$ Á
|
|||
|
|
Ñ·µÑ¿$‰$ üø$, üÒ$! òž¬ÿ$ î îž¿ Á •% Á
|
|||
|
|
Ò·µÑ¿$–% ü‡&< üá%! ûŸÌŽ& ï ïž¿ Á ¨& Á
|
|||
|
|
Ó·µÑ¿$& ø D³& üŽ(, üŒ'O L Consumes the `FramedWrite`, returning its underlying I/O stream, the bufferÁ üà') ³£T•( ž¿ ª ª ïQ ’R ®ï1 ¯¤R °´R ±³E { ä�áT·µÑ¿ Á Á
|
|||
|
|
Ô·µÑ¿$ ( üÑ*v ¥ Ö š × – Ø Ö × Ø Ëì Ö* ƒå Ù* Í솿 Ü* ›ßTŠ+ ¥º T�+ é †¿¥º ñ®Ç |·+ Ý¿ÙÚÛÜÝ
|
|||
|
|
Û Ý Ü Ú ŠŒ �‘ ‹� TÎ+ ,Ó+ Õ Õ ™� üê+Z Tí+ ð ñ ò„¾„¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• ðÝ¿ ñÌ�Ì� k Î�´¸� Ï�éÿ¸� Ð�‚€¸� Ñ�“€¸� Ò�¨€¸� f'EwÚ]¾å òœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ý¿¥º Õ ‚, Õ
|
|||
|
|
Ú·µ¥º†¿$ø+ õ׎, üþ,G T�- 󄾄¾ ˆ‚ †¾‰ ˜X $ ]È=„kt• óÝ¿¥º×„ Õ –- Õ
|
|||
|
|
Û·µ¥º†¿$Œ- ÷$¢-
|
|||
|
|
` £cÍj ` àB¤GS
|
|||
|
|
ÿå§ ã ¹3 ã
|
|||
|
|
æ·µ½µ$º3 ± À3 üŽf …ŒÄ°f ü 4
|
|||
|
|
1 Frame a stream of bytes based on a length prefixÁ 5
|
|||
|
|
ú ü9F
|
|||
|
|
C Many protocols delimit their frames by prefacing frame data with aÁ ü€:
|
|||
|
|
7 frame head that specifies the length of the frame. TheÁ ü»H
|
|||
|
|
E `length_delimited` module provides utilities for handling the lengthÁ ü„F
|
|||
|
|
C based framing. This allows the consumer to work with entire framesÁ üËC
|
|||
|
|
@ without having to worry about buffering or other framing logic.Á �
|
|||
|
|
ú ¬“
|
|||
|
|
# Getting startedÁ ©
|
|||
|
|
ú üK
|
|||
|
|
H If implementing a protocol from scratch, using length delimited framingÁ üùG
|
|||
|
|
D is an easy way to get started. [`LengthDelimitedCodec::new()`] willÁ üÁG
|
|||
|
|
D return a length delimited codec using default configuration values.Á ü‰F
|
|||
|
|
C This can then be used to construct a framer to adapt a full-duplexÁ üÐ(
|
|||
|
|
% byte stream into a stream of frames.Á ù
|
|||
|
|
ú <ý
|
|||
|
|
Ó¤ ü…+
|
|||
|
|
( use tokio::io::{AsyncRead, AsyncWrite};Á ü±:
|
|||
|
|
7 use tokio_util::codec::{Framed, LengthDelimitedCodec};Á ì
|
|||
|
|
ú üð7
|
|||
|
|
4 fn bind_transport<T: AsyncRead + AsyncWrite>(io: T)Á ü¨*
|
|||
|
|
' -> Framed<T, LengthDelimitedCodec>Á ,Ó
|
|||
|
|
{Á üÙ4
|
|||
|
|
1 Framed::new(io, LengthDelimitedCodec::new())Á ,Ž
|
|||
|
|
Ť ´”
|
|||
|
|
# pub fn main() {}Á <«
|
|||
|
|
Ó¤ ³
|
|||
|
|
ú ü·H
|
|||
|
|
E The returned transport implements `Sink + Stream` for `BytesMut`. ItÁ ü€ G
|
|||
|
|
D encodes the frame with a big-endian `u32` header denoting the frameÁ œÈ
|
|||
|
|
payload length:Á Ü
|
|||
|
|
ú \à
|
|||
|
|
```textÁ üì 1
|
|||
|
|
. +----------+--------------------------------+Á üž
|
|||
|
|
1
|
|||
|
|
. | len: u32 | frame payload |Á üÐ
|
|||
|
|
1
|
|||
|
|
ï� <‚
|
|||
|
|
Ó¤ Š
|
|||
|
|
ú üŽ &
|
|||
|
|
# Specifically, given the following:Á µ
|
|||
|
|
ú <¹
|
|||
|
|
Ó¤ üÁ +
|
|||
|
|
…™ üí :
|
|||
|
|
º™ ¨
|
|||
|
|
ú ̬
|
|||
|
|
use futures::SinkExt;Á ¬Æ
|
|||
|
|
use bytes::Bytes;Á Ü
|
|||
|
|
ú üà L
|
|||
|
|
I async fn write_frame<T>(io: T) -> Result<(), Box<dyn std::error::Error>>Á L
|
|||
|
|
|
|||
|
|
whereÁ ü·
|
|||
|
|
*
|
|||
|
|
' T: AsyncRead + AsyncWrite + Unpin,Á ,â
|
|||
|
|
|
|||
|
|
þš üè
|
|||
|
|
I
|
|||
|
|
F let mut transport = Framed::new(io, LengthDelimitedCodec::new());Á ü²/
|
|||
|
|
, let frame = Bytes::from("hello world");Á â
|
|||
|
|
ú üæ%
|
|||
|
|
" transport.send(frame).await?;Á tŒ
|
|||
|
|
æÙ ,›
|
|||
|
|
Ť <¡
|
|||
|
|
Ó¤ ©
|
|||
|
|
ú ü*
|
|||
|
|
' The encoded frame will look like this:Á Ø
|
|||
|
|
ú \Ü
|
|||
|
|
Ú� üè'
|
|||
|
|
$ +---- len: u32 ----+---- data ----+Á ü�'
|
|||
|
|
$ | \x00\x00\x00\x0b | hello world |Á ü¸'
|
|||
|
|
$ +------------------+--------------+Á <à
|
|||
|
|
Ó¤ è
|
|||
|
|
ú tì
|
|||
|
|
# DecodingÁ û
|
|||
|
|
ú üÿK
|
|||
|
|
H [`FramedRead`] adapts an [`AsyncRead`] into a `Stream` of [`BytesMut`],Á üËI
|
|||
|
|
F such that each yielded [`BytesMut`] value contains the contents of anÁ ü•B
|
|||
|
|
? entire frame. There are many configuration parameters enablingÁ üØE
|
|||
|
|
B [`FramedRead`] to handle a wide range of protocols. Here are someÁ üžA
|
|||
|
|
> examples that will cover the various options at a high level.Á à
|
|||
|
|
ú „ä
|
|||
|
|
|
|||
|
|
## Example 1Á õ
|
|||
|
|
ú üùK
|
|||
|
|
H The following will parse a `u16` length field at offset 0, omitting theÁ üÅ)
|
|||
|
|
& frame head in the yielded `BytesMut`.Á ï
|
|||
|
|
ú <ó
|
|||
|
|
Ó¤ üû"
|
|||
|
|
# use tokio_stream::StreamExt;Á üž2
|
|||
|
|
/ # use tokio_util::codec::LengthDelimitedCodec;Á üÑ/
|
|||
|
|
ØÆ ¼�
|
|||
|
|
„� ü™-
|
|||
|
|
* # let io: &[u8] = b"\x00\x0BHello world";Á üÇ4
|
|||
|
|
1 let mut reader = LengthDelimitedCodec::builder()Á üü0
|
|||
|
|
- .length_field_offset(0) // default valueÁ ü#
|
|||
|
|
.length_field_type::<u16>()Á üÑ0
|
|||
|
|
- .length_adjustment(0) // default valueÁ ´‚
|
|||
|
|
.new_read(io);Á ü™?
|
|||
|
|
< # let res = reader.next().await.unwrap().unwrap().to_vec();Á üÙ&
|
|||
|
|
# # assert_eq!(res, b"Hello world");Á <€
|
|||
|
|
²Í <ˆ
|
|||
|
|
Ó¤ �
|
|||
|
|
ú ü”0
|
|||
|
|
- The following frame will be decoded as such:Á Å
|
|||
|
|
ú \É
|
|||
|
|
Ú� üÕ1
|
|||
|
|
. INPUT DECODEDÁ ü‡6
|
|||
|
|
3 +-- len ---+--- Payload ---+ +--- Payload ---+Á ü¾6
|
|||
|
|
3 | \x00\x0B | Hello world | --> | Hello world |Á üõ6
|
|||
|
|
3 +----------+---------------+ +---------------+Á <¬
|
|||
|
|
Ó¤ ´
|
|||
|
|
ú ü¸L
|
|||
|
|
I The value of the length field is 11 (`\x0B`) which represents the lengthÁ ü… J
|
|||
|
|
G of the payload, `hello world`. By default, [`FramedRead`] assumes thatÁ üÐ H
|
|||
|
|
E the length field represents the number of bytes that **follows** theÁ ü™ L
|
|||
|
|
I length field. Thus, the entire frame has a length of 13: 2 bytes for theÁ üæ *
|
|||
|
|
' frame head + 11 bytes for the payload.Á ‘
|
|||
|
|
ú „•
|
|||
|
|
|
|||
|
|
## Example 2Á ¦
|
|||
|
|
ú üª L
|
|||
|
|
I The following will parse a `u16` length field at offset 0, including theÁ ü÷ )
|
|||
|
|
œª ¡
|
|||
|
|
ú <¥
|
|||
|
|
Ó¤ ü "
|
|||
|
|
èª üÐ 2
|
|||
|
|
”« üƒ /
|
|||
|
|
ØÆ ¼³
|
|||
|
|
„� üË -
|
|||
|
|
ë« üù 4
|
|||
|
|
¢¬ ü®!0
|
|||
|
|
ଠüß!#
|
|||
|
|
š üƒ":
|
|||
|
|
7 .length_adjustment(2) // Add head size to lengthÁ ü¾"7
|
|||
|
|
4 .num_skip(0) // Do NOT skip the headÁ ´ö"
|
|||
|
|
€® ü�#?
|
|||
|
|
® üÍ#.
|
|||
|
|
+ # assert_eq!(res, b"\x00\x0BHello world");Á <ü#
|
|||
|
|
²Í <„$
|
|||
|
|
Ó¤ Œ$
|
|||
|
|
ú ü�$0
|
|||
|
|
¿¯ Á$
|
|||
|
|
ú \Å$
|
|||
|
|
Ú� üÑ$4
|
|||
|
|
1 INPUT DECODEDÁ ü†%A
|
|||
|
|
> +-- len ---+--- Payload ---+ +-- len ---+--- Payload ---+Á üÈ%A
|
|||
|
|
> | \x00\x0B | Hello world | --> | \x00\x0B | Hello world |Á üŠ&A
|
|||
|
|
> +----------+---------------+ +----------+---------------+Á <Ì&
|
|||
|
|
Ó¤ Ô&
|
|||
|
|
ú üØ&I
|
|||
|
|
F This is similar to the first example, the only difference is that theÁ ü¢'J
|
|||
|
|
G frame head is **included** in the yielded `BytesMut` value. To achieveÁ üí'P
|
|||
|
|
M this, we need to add the header size to the length with `length_adjustment`,Á ü¾(;
|
|||
|
|
8 and set `num_skip` to `0` to prevent skipping the head.Á
|
|||
|
|
included.Á •C
|
|||
|
|
ú <™C
|
|||
|
|
Ó¤ ü¡C"
|
|||
|
|
èª üÄC2
|
|||
|
|
”« ü÷C/
|
|||
|
|
ØÆ ¼§D
|
|||
|
|
„� ü¿D5
|
|||
|
|
2 # let io: &[u8] = b"\xCA\x00\x0B\xFEHello world";Á üõD4
|
|||
|
|
¢¬ üªE1
|
|||
|
|
. .length_field_offset(1) // length of hdr1Á üÜE#
|
|||
|
|
š ü€F0
|
|||
|
|
- .length_adjustment(1) // length of hdr2Á ü±F,
|
|||
|
|
) .num_skip(3) // length of hdr1 + LENÁ ´ÞF
|
|||
|
|
€® üõF?
|
|||
|
|
® üµG*
|
|||
|
|
' # assert_eq!(res, b"\xFEHello world");Á <àG
|
|||
|
|
²Í <èG
|
|||
|
|
Ó¤ ðG
|
|||
|
|
ú üôG0
|
|||
|
|
¿¯ ¥H
|
|||
|
|
ú \©H
|
|||
|
|
Ú� ÔµH
|
|||
|
|
ñÌ üÐH2
|
|||
|
|
/ +- hdr1 -+-- len ---+- hdr2 -+--- Payload ---+Á üƒI2
|
|||
|
|
/ | \xCA | \x00\x0B | \xFE | Hello world |Á ü¶I2
|
|||
|
|
/ +--------+----------+--------+---------------+Á éI
|
|||
|
|
ú ¤íI
|
|||
|
|
DECODEDÁ ô‚J
|
|||
|
|
+- hdr2 -+--- Payload ---+Á ô¡J
|
|||
|
|
| \xFE | Hello world |Á ôÀJ
|
|||
|
|
+--------+---------------+Á <ßJ
|
|||
|
|
Ó¤ çJ
|
|||
|
|
ú üëJI
|
|||
|
|
F The length field is situated in the middle of the frame head. In thisÁ üµKK
|
|||
|
|
H case, the first byte in the frame head could be a version or some otherÁ ü�LH
|
|||
|
|
E identifier that is not needed for processing. On the other hand, theÁ üÊL&
|
|||
|
|
# second half of the head is needed.Á ñL
|
|||
|
|
ú üõLJ
|
|||
|
|
G `length_field_offset` indicates how many bytes to skip before startingÁ üÀML
|
|||
|
|
I to read the length field. `length_adjustment` is the number of bytes toÁ ü�NI
|
|||
|
|
F skip starting at the end of the length field. In this case, it is theÁ ä×N
|
|||
|
|
second half of the head.Á ôN
|
|||
|
|
ú „øN
|
|||
|
|
|
|||
|
|
## Example 6Á ‰O
|
|||
|
|
ú ü�OI
|
|||
|
|
õÓ ü×OL
|
|||
|
|
ÈÔ ü¤PJ
|
|||
|
|
žÕ üïPH
|
|||
|
|
E included. In this case, the length field **includes** the frame headÁ \¸Q
|
|||
|
|
length.Á ÄQ
|
|||
|
|
ú <ÈQ
|
|||
|
|
Ó¤ üÐQ"
|
|||
|
|
èª üóQ2
|
|||
|
|
”« ü¦R/
|
|||
|
|
ØÆ ¼ÖR
|
|||
|
|
„� üîR5
|
|||
|
|
2 # let io: &[u8] = b"\xCA\x00\x0F\xFEHello world";Á ü¤S4
|
|||
|
|
¢¬ üÙS1
|
|||
|
|
¥× ü‹T#
|
|||
|
|
š ü¯TA
|
|||
|
|
> .length_adjustment(-3) // length of hdr1 + LEN, negativeÁ ¤ñT
|
|||
|
|
.num_skip(3)Á ´†U
|