2301 lines
694 KiB
Plaintext
2301 lines
694 KiB
Plaintext
|
rust
|
|||
|
|
3Ö
|
|||
|
|
#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Á,¿¢¨˜É0!ñ?-…”¼9 -3beca82a6f76b5d4Á mioÁGù�j0ðÔ·â"FÆ#0Q -3545320490828222Á –æ\‹±Ôcd�-»ùÀTƒ -f86f80b348d33b13Á bytesÁ�`²['3_ ²µÆ=üå¥ -d4f44708ed5da7b6Á socket2ÁsT›¸n>~R�Ê1G/R -c161f09f0083d1e0Á 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Á ÈÙÄ ÙŽ. Ç Ç decoderÁ Ý ÝÝÝÝÝÝ DecoderÁ ä› äÄ äó- ä
|
|||
|
|
decode_eofÁ ä framedÁ é¥ ÇÇ encoderÁ ì ìì EncoderÁ ï› ïÄ ïŽ. ÇÇ framed_implÁ ô ôôôôôôôôô ô
|
|||
|
|
ô ô ô
|
|||
|
|
ôôôôô INITIAL_CAPACITYÁ ô
|
|||
|
|
WriteFrameÁ ˆ bufferÁ ˆ backpressure_boundaryÁ ô ‹> ô�> ô�÷ ô‘÷ ô“ borrowÁ ô•
|
|||
|
|
borrow_mutÁ ô—õ1 ô™ˆ2 ô›¥ ›¦ ›£ ›› ›Î ô ¥¥ ¥š ¥¦ ¥¨ ¥Ä ¥Ñ ¥õ ¥ã ¥‡ ÇÇÇÇÇÇœ/ µ µµµµµµµµµ µ
|
|||
|
|
µ µ µ
|
|||
|
|
µµµµµµµ Ê¥ ʦ Êæ Ê
|
|||
|
|
with_capacityÁ Ê
|
|||
|
|
from_partsÁ Êô Ê get_mutÁ Ê get_pin_mutÁ ÊŽ- Ê codec_mutÁ Ê map_codecÁ Õ” Õ— Ê
|
|||
|
|
codec_pin_mutÁ Ê read_bufferÁ Ê read_buffer_mutÁ Ê write_bufferÁ Ê write_buffer_mutÁ Ê¡1 Ê set_backpressure_boundaryÁ ÊÇ Ê
|
|||
|
|
into_partsÁ µá¥ ᦠᛠáÎ µæ¥ æš æ¦ æÄ æÑ æõ æã æ‡ µï¥ ï¦ ï× µó¥ ó¦ óæ öš ÇÇ Ç
|
|||
|
|
Ç framed_readÁ û ûûûûûûûûû û
|
|||
|
|
û û û
|
|||
|
|
ûû ‹¥ ‹• ‹æ ‹é4 ‹ô ‹˜5 ‹§5 ‹Ç ‹¶. ‹ decoder_mutÁ ‹ map_decoderÁ –” –— ‹ decoder_pin_mutÁ ‹‰6 ‹œ6 ‹�7 û�¥ �• �› �Î û¢¥ ¢š ¢• ¢Ä ¢Ñ ¢õ ¢ã ¢‡ û«¥ «• «× Ç Ç framed_writeÁ ° °°°°°°°°° °
|
|||
|
|
° ° °
|
|||
|
|
°°° Á¥ Á– Áæ Áé4 Áô Á˜5 Á§5 ÁÇ Á·/ Á encoder_mutÁ Á map_encoderÁ Ì” Ì— Á encoder_pin_mutÁ Á³6 ÁÇ6 Á¡1 Áç6 Á�7 °Õ¥ Õš Õ– ÕÄ ÕÑ Õõ Õã Õ‡ °Þ¥ Þ• Þ› ÞÎ °ã¥ 㦠ã× Ç Ç length_delimitedÁ è èèèèèèèèè è
|
|||
|
|
è è è
|
|||
|
|
èèèèèèèèè LengthDelimitedCodecErrorÁ ÿ _privÁ è �æ � builderÁ � max_frame_lengthÁ � set_max_frame_lengthÁ � decode_headÁ � decode_dataÁ 舛 ˆÄ ˆó- èŒÄ ŒŽ. Ž è�> èì@ ’ LengthFieldTypeÁ ’ ’’’’è™æ ™
|
|||
|
|
big_endianÁ ™
|
|||
|
|
little_endianÁ ™
|
|||
|
|
native_endianÁ ™û@ ™ 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Á ¹Ì› ÌÄ Ìó- Ï ÌŠ/ ¹Ò¥ ÒÄ ÒŽ. ¹Ö> ¹Ø× ¹Ú÷ ¹ÇÇÇÇ any_delimiter_codecÁ à ààààààààà à
|
|||
|
|
à à DEFAULT_SEEK_DELIMITERSÁ à DEFAULT_SEQUENCE_WRITERÁ à ïæ ïÔF ïïF àó› óÄ óó- ö óŠ/ àù¥ ùÄ ùŽ. àý> àÿ× à�÷ àÇÇÇÈ
|
|||
|
|
BytesCodecÁ ‡
|
|||
|
|
‡ˆ ÈÈÈŒƒ ÈŽ× È�Ö È È
|
|||
|
|
“� È •‹ È —ï
|
|||
|
|
È
|
|||
|
|
™§ šù Èœ> ô ReadFrameÁ ž eofÁ ž is_readableÁ ž“1 ž has_erroredÁ ô
|
|||
|
|
£× ô RWFramesÁ ¥ readÁ ¥ writeÁ ô ¨> µ FramedPartsÁ ª¥ ª¦ ª ioÁ ªŽ- ª read_bufÁ ª write_bufÁ ªÒ@ µ²¥ ²¦ ²× è BuilderÁ ¶
|
|||
|
|
max_frame_lenÁ ¶ length_field_lenÁ ¶ÝC ¶øC ¶‘D ¶ length_field_is_big_endianÁ è ½× è
|
|||
|
|
è Àƒ è è LengthDelimitedCodecÁ Ãì@ ú è
|
|||
|
|
Æ× èȃ è DecodeStateÁ Ê HeadÁ Ë
|
|||
|
|
Ê DataÁ Í
|
|||
|
|
͈ èÐ× èèÓƒ è¹
|
|||
|
|
LinesCodecÁ Ö
|
|||
|
|
next_indexÁ ÖïF Ö
|
|||
|
|
is_discardingÁ ¹Úƒ ¹Ü× ¹ ÞÖ ¹
|
|||
|
|
¹ á� ¹ ã‹ ¹
|
|||
|
|
åï
|
|||
|
|
¹ç§ èù ¹ LinesCodecErrorÁ ê MaxLineLengthExceededÁ ë
|
|||
|
|
ê IoÁ í
|
|||
|
|
íˆ ¹ð× à AnyDelimiterCodecÁ òÜP òïF òöP ò seek_delimitersÁ ò sequence_writerÁ àøƒ àú× à üÖ à
|
|||
|
|
à ÿ� à �‹ à
|
|||
|
|
ĕ
|
|||
|
|
à…§ †ù à AnyDelimiterCodecErrorÁ ˆ MaxChunkLengthExceededÁ ‰
|
|||
|
|
ˆ¬R ‹
|
|||
|
|
‹ˆ àŽ× ±M �
|
|||
|
|
copy_to_bytesÁ ‘ ‘‘‘‘‘‘‘‘ š¤ šæ šô š˜5 šÇ ‘ ý ¤ Ä Ñ õ ã ‡ ‘¨¤ ¨› ¨Î � inspectÁ ¬ ¬¬¬¬¬¬¬¬¬ ¬
|
|||
|
|
¬ ¬ ¬ º£ º— ºæ ºÇ ¬¿£ ¿— ¿³$ ¬Ã£ × ÃÎ% Ãã Ãè% Ãý% Ø& ¬Ë¨ Ë— Ëæ ËÇ ¬Ð¨ З ÐÎ% Ðã Ðè% Ðý% И& ¬Ø¨ Ø— س$ �ÃM Ü ÜÜÜÜÜÜÜÜÃM å£ å“ å å é ReadBufFnÁ ê
|
|||
|
|
êý ê£ ê“ êˆ ê‰ é ñý ñ£ ñ“ ñ° ñŠ �
|
|||
|
|
reader_streamÁ ÷ ÷÷÷÷÷÷÷÷÷ ÷ DEFAULT_CAPACITYÁ ÷ ƒ £ ƒ æ ƒ é4 ÷‡ £ ‡ › ‡ Î Š � simplexÁ Œ Œ Œ Œ Œ Œ Œ Œ Œ Œ Œ
|
|||
|
|
Œ Œ Œ
|
|||
|
|
Œ Œ Œ Œ Œ Œ IoResultÁ ¥ Œ CLOSED_ERROR_MSGÁ Œ £ é4 £ register_receiver_wakerÁ £ register_sender_wakerÁ £ take_receiver_wakerÁ £ take_sender_wakerÁ £ ã £ close_receiverÁ £ close_senderÁ Œ ¬ ã Œ ® ³$ Œ ° ã Œ ² Î% ² ã ² è% ² ˜& ² ý% Œ æ � sink_writerÁ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹ ¹
|
|||
|
|
¹ ¹ Æ ¤ Æ æ Æ ô Æ ˜5 Æ Ç ¹ Ì ¤ Ì – Ì ý Ì Î% Ì ã Ì è% ¹ Ó ¤ Ó › Ó Î ¹ × ¤ × ³$ �
|
|||
|
|
stream_readerÁ Ú Ú Ú Ú Ú Ú Ú Ú Ú Ú Ú
|
|||
|
|
Ú Ú ç ¤ ç “ ç – ç æ ç has_chunkÁ ç into_inner_with_chunkÁ Ú î ¤ î “ î ô î ˜5 î §5 î Ç Ú õ ¤ õ “ õ – õ ³$ Ú ú ¤ ú “ ú – ú Ù$ ú î$ Ú €
|
|||
|
|
¤ €
|
|||
|
|
“ Ú StreamReaderProjectÁ ƒ
|
|||
|
|
ý ƒ
|
|||
|
|
¤ ƒ
|
|||
|
|
“ ƒ
|
|||
|
|
Ç ƒ
|
|||
|
|
chunkÁ Ú ‰
|
|||
|
|
¤ ‰
|
|||
|
|
“ ‰
|
|||
|
|
projectÁ Ú �
|
|||
|
|
¤ �
|
|||
|
|
“ �
|
|||
|
|
– �
|
|||
|
|
¥ �
|
|||
|
|
Ä �
|
|||
|
|
Ñ �
|
|||
|
|
õ �
|
|||
|
|
ã �
|
|||
|
|
‡ � ��������� �
|
|||
|
|
Œ ù ¢
|
|||
|
|
¡1 ¢
|
|||
|
|
ã ¢
|
|||
|
|
receiver_wakerÁ ¢
|
|||
|
|
sender_wakerÁ ¢
|
|||
|
|
bufÁ Œ ¨
|
|||
|
|
× Œ ReceiverÁ ª
|
|||
|
|
Ç Œ ¬
|
|||
|
|
× Œ SenderÁ ®
|
|||
|
|
Ç Œ °
|
|||
|
|
× Ú StreamReaderÁ ²
|
|||
|
|
¤ ²
|
|||
|
|
“ ²
|
|||
|
|
Ç ²
|
|||
|
|
õc Ú ·
|
|||
|
|
¤ ·
|
|||
|
|
“ ·
|
|||
|
|
× DropGuardÁ »
|
|||
|
|
Ç ½
|
|||
|
|
× DropGuardRefÁ ¿
|
|||
|
|
ý ¿
|
|||
|
|
Ç Â
|
|||
|
|
ý Â
|
|||
|
|
× WaitForCancellationFutureÁ Å
|
|||
|
|
ý Å
|
|||
|
|
¥ Å
|
|||
|
|
œ* É
|
|||
|
|
Ê
|
|||
|
|
ý É
|
|||
|
|
__assert_not_repr_packedÁ Ì
|
|||
|
|
ý É
|
|||
|
|
|
|||
|
|
ProjectionÁ Î
|
|||
|
|
'__pinÁ Î
|
|||
|
|
ý Î
|
|||
|
|
¥ Î
|
|||
|
|
œ* É
|
|||
|
|
|
|||
|
|
ProjectionRefÁ Ó
|
|||
|
|
ýh Ó
|
|||
|
|
ý Ó
|
|||
|
|
¥ Ó
|
|||
|
|
œ* Ê
|
|||
|
|
—d Ø
|
|||
|
|
ýh Ê
|
|||
|
|
project_refÁ Ú
|
|||
|
|
ýh É
|
|||
|
|
__OriginÁ Ü
|
|||
|
|
ýh Ü
|
|||
|
|
ý Ü
|
|||
|
|
__dummy_lifetimeÁ Ü
|
|||
|
|
¥ Ü
|
|||
|
|
œ* É
|
|||
|
|
â
|
|||
|
|
ýh â
|
|||
|
|
ý É
|
|||
|
|
MustNotImplDropÁ É
|
|||
|
|
æ
|
|||
|
|
¥ É
|
|||
|
|
è
|
|||
|
|
ý WaitForCancellationFutureOwnedÁ ê
|
|||
|
|
œ* ê
|
|||
|
|
¥ í
|
|||
|
|
í
|
|||
|
|
Ãh í
|
|||
|
|
ëh ð
|
|||
|
|
ýh ð
|
|||
|
|
œ* ð
|
|||
|
|
¥ í
|
|||
|
|
£i ô
|
|||
|
|
ýh ô
|
|||
|
|
œ* ô
|
|||
|
|
¥ î
|
|||
|
|
—d ø
|
|||
|
|
ýh î
|
|||
|
|
èi ú
|
|||
|
|
ýh í
|
|||
|
|
ƒj ü
|
|||
|
|
ýh ü
|
|||
|
|
£j ü
|
|||
|
|
œ* ü
|
|||
|
|
¥ í
|
|||
|
|
� ýh í
|
|||
|
|
àj í
|
|||
|
|
„ ¥ í
|
|||
|
|
RunUntilCancelledFutureÁ ‡ ý ‡ — ‡ cancellationÁ ‡ œ* Œ � ý � — Œ Ãh � ý � — Œ ëh “ ýh “ ý “ — “ ¶m “ œ* Œ £i ™ ýh ™ ý ™ — ™ ¶m ™ œ* � —d Ÿ ýh � èi ¡ ýh Œ ƒj £ ýh £ ý £ — £ £j £ ¶m £ œ* Œ ª ýh ª ý ª — Œ àj Œ ¯ ¥ Œ ± ý ± — RunUntilCancelledFutureOwnedÁ ´ — ´ ¶m ´ œ* ¸ ¹ — ¸ Ãh » — ¸ ëh ½ ýh ½ — ½ ¶m ½ œ* ¸ £i  ýh  —  ¶m  œ* ¹ —d Ç ýh ¹ èi É ýh ¸ ƒj Ë ýh Ë — Ë £j Ë ¶m Ë œ* ¸ Ñ ýh Ñ — ¸ àj ¸ Õ ¥ ¸ × — �
|
|||
|
|
PollSendErrorÁ Ù
|
|||
|
|
Ù ¥ Ù ˆ �Ý ¥ Ý × � StateÁ à ¥ à IdleÁ â
|
|||
|
|
â ˆ à AcquiringÁ å
|
|||
|
|
à ReadyToSendÁ ç
|
|||
|
|
ç ˆ à ClosedÁ ê
|
|||
|
|
� ì ¥ ì × �
|
|||
|
|
PollSenderÁ ï ¥ ï senderÁ ï º ï acquireÁ �
|
|||
|
|
ô ¥ ô × � PollSenderFutureÁ ÷
|
|||
|
|
÷ ¥ ÷ ˆ � û ¥ û × ¬ EitherÁ þ � þ £ þ LeftÁ �
|
|||
|
|
� ˆ þ RightÁ „
|
|||
|
|
„ ˆ ¬‡ � ‡ £ ‡ × ¬‹ � ‹ £ ‹ ƒ èèèè RestoreOnPendingÁ ’
|
|||
|
|
è ”
|
|||
|
|
made_progressÁ èØ
|
|||
|
|
œ WithCancellationTokenFutureÁ — ý — — — ± œ › œ ý œ — › Ãh Ÿ ý Ÿ — › ëh ¢ ýh ¢ ý ¢ — ¢ ± › £i § ýh § ý § — § ± œ —d ¬ ýh œ èi ® ýh › ƒj ° ýh ° ý ° — ° £j ° ± › ¶ ýh ¶ ý ¶ — › àj › » ¥ › ½ ý ½ — œ WithCancellationTokenFutureOwnedÁ À — À ± œÃ Ä — à Ãh Æ — à ëh È ýh È — È ± à £i Ì ýh Ì — Ì ± Ä —d Ð ýh Ä èi Ò ýh à ƒj Ô ýh Ô — Ô £j Ô ± à ٠ýh Ù — à àj Ã Ý ¥ Ã ß — ¹
|
|||
|
|
SinkWriterÁ á ¤ á Ç ¹ ä ¤ ä × ¹ ç è ¤ ç Ãh ê ¤ ç ëh ì ýh ì ¤ ì Ç ç £i ð ýh ð ¤ ð Ç è —d ô ýh è èi ö ýh ç ƒj ø ýh ø ¤ ø £j ø Ç ç ý ýh ý ¤ ç àj ç �
|
|||
|
|
¥ ç ƒ
|
|||
|
|
¤ ÷ ReaderStreamÁ …
|
|||
|
|
£ …
|
|||
|
|
readerÁ …
|
|||
|
|
ìe …
|
|||
|
|
capacityÁ ÷Š
|
|||
|
|
£ Š
|
|||
|
|
× ÷ �
|
|||
|
|
Ž
|
|||
|
|
£ �
|
|||
|
|
Ãh �
|
|||
|
|
£ �
|
|||
|
|
ëh ’
|
|||
|
|
ýh ’
|
|||
|
|
£ ’
|
|||
|
|
š~ ’
|
|||
|
|
ìe ’
|
|||
|
|
°~ �
|
|||
|
|
£i ˜
|
|||
|
|
ýh ˜
|
|||
|
|
£ ˜
|
|||
|
|
š~ ˜
|
|||
|
|
ìe ˜
|
|||
|
|
°~ Ž
|
|||
|
|
—d ž
|
|||
|
|
ýh Ž
|
|||
|
|
èi
|
|||
|
|
ýh �
|
|||
|
|
ƒj ¢
|
|||
|
|
ýh ¢
|
|||
|
|
£ ¢
|
|||
|
|
£j ¢
|
|||
|
|
š~ ¢
|
|||
|
|
ìe ¢
|
|||
|
|
°~ �
|
|||
|
|
©
|
|||
|
|
ýh ©
|
|||
|
|
£ �
|
|||
|
|
àj �
|
|||
|
|
|
|||
|
|
¥ �
|
|||
|
|
¯
|
|||
|
|
£ ¬
|
|||
|
|
InspectWriterÁ ±
|
|||
|
|
¨ ±
|
|||
|
|
— ±
|
|||
|
|
writerÁ ±
|
|||
|
|
± ¬ ¶
|
|||
|
|
·
|
|||
|
|
¨ ·
|
|||
|
|
— ¶
|
|||
|
|
Ãh º
|
|||
|
|
¨ º
|
|||
|
|
— ¶
|
|||
|
|
ëh ½
|
|||
|
|
ýh ½
|
|||
|
|
¨ ½
|
|||
|
|
— ½
|
|||
|
|
�� ½
|
|||
|
|
± ¶
|
|||
|
|
£i Ã
|
|||
|
|
ýh Ã
|
|||
|
|
¨ Ã
|
|||
|
|
— Ã
|
|||
|
|
�� Ã
|
|||
|
|
± ·
|
|||
|
|
—d É
|
|||
|
|
ýh ·
|
|||
|
|
èi Ë
|
|||
|
|
ýh ¶
|
|||
|
|
ƒj Í
|
|||
|
|
ýh Í
|
|||
|
|
¨ Í
|
|||
|
|
— Í
|
|||
|
|
£j Í
|
|||
|
|
�� Í
|
|||
|
|
± ¶
|
|||
|
|
Ô
|
|||
|
|
ýh Ô
|
|||
|
|
¨ Ô
|
|||
|
|
— ¶
|
|||
|
|
àj ¶
|
|||
|
|
Ù
|
|||
|
|
¥ ¶
|
|||
|
|
Û
|
|||
|
|
¨ Û
|
|||
|
|
— ¬
|
|||
|
|
InspectReaderÁ Þ
|
|||
|
|
£ Þ
|
|||
|
|
— Þ
|
|||
|
|
š~ Þ
|
|||
|
|
± ¬ã
|
|||
|
|
ä
|
|||
|
|
£ ä
|
|||
|
|
— ã
|
|||
|
|
Ãh ç
|
|||
|
|
£ ç
|
|||
|
|
— ã
|
|||
|
|
ëh ê
|
|||
|
|
ýh ê
|
|||
|
|
£ ê
|
|||
|
|
— ê
|
|||
|
|
š~ ê
|
|||
|
|
± ã
|
|||
|
|
£i ð
|
|||
|
|
ýh ð
|
|||
|
|
£ ð
|
|||
|
|
— ð
|
|||
|
|
š~ ð
|
|||
|
|
± ä
|
|||
|
|
—d ö
|
|||
|
|
ýh ä
|
|||
|
|
èi ø
|
|||
|
|
ýh ã
|
|||
|
|
ƒj ú
|
|||
|
|
ýh ú
|
|||
|
|
£ ú
|
|||
|
|
— ú
|
|||
|
|
£j ú
|
|||
|
|
š~ ú
|
|||
|
|
± ã
|
|||
|
|
�ýh �£ �— ã
|
|||
|
|
àj ã
|
|||
|
|
†¥ ã
|
|||
|
|
ˆ£ ˆ— ‘ CopyToBytesÁ ‹¤ ‹Ç ‘Ž¤ Ž× ‘ ‘ ’¤ ‘Ãh ”¤ ‘ëh –ýh –¤ –Ç ‘£i šýh š¤ šÇ ’—d žýh ’èi ýh ‘ƒj ¢ýh ¢¤ ¢£j ¢Ç ‘§ýh §¤ ‘àj ‘«¥ ‘¤ ° FramedWriteÁ ¯¥ ¯– ¯Ç ° ³ ´¥ ´– ³Ãh ·¥ ·– ³ëh ºýh º¥ º– ºÇ ³£i ¿ýh ¿¥ ¿– ¿Ç ´—d Äýh ´èi Æýh ³ƒj Èýh È¥ È– È£j ÈÇ ³Îýh Î¥ Ζ ³àj ³Ó¥ ³Õ¥ Õ– û
|
|||
|
|
FramedReadÁ Ø¥ Ø• ØÇ û Ü Ý¥ Ý• ÜÃh à¥ à• Üëh ãýh 㥠㕠ãÇ Ü£i èýh è¥ è• èÇ Ý—d íýh Ýèi ïýh ܃j ñýh ñ¥ ñ• ñ£j ñÇ Ü÷ýh ÷¥ ÷• Üàj Üü¥ Üþ¥ þ• µ FramedÁ �¥ �¦ �Ç µ … †¥ †¦ …Ãh ‰¥ ‰¦ …ëh Œýh Œ¥ Œ¦ ŒÇ …£i ‘ýh ‘¥ ‘¦ ‘Ç †—d –ýh †èi ˜ýh …ƒj šýh š¥ š¦ š£j šÇ … ýh ¥ ¦ …àj …¥¥ …§¥ §¦ ô
|
|||
|
|
FramedImplÁ ª¥ ª¦ ªør ªÇ ªº ªŽ- ô ±¥ ±¦ ±ør ±× ô ¶ ·¥ ·¦ ·ør ¶Ãh »¥ »¦ »ør ¶ëh ¿ýh ¿¥ ¿¦ ¿ør ¿Ç ¿º ¿Ž- ¶£i Çýh Ç¥ Ǧ Çør ÇÇ Çº ÇŽ- ·—d Ïýh ·èi Ñýh ¶ƒj Óýh Ó¥ Ó¦ Óør Ó£j ÓÇ Óº ÓŽ- ¶Üýh Ü¥ ܦ Üør ¶àj ¶â¥ ¶ä¥ ä¦ äør
|
|||
|
|
|
|||
|
|
|
|||
|
|
*
|
|||
|
|
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 äïá¤ûÒ“ª…Ø
|
|||
|
|
¬
|
|||
|
|
€
|
|||
|
|
å
|
|||
|
|
ƒ ® Ô º Ü ¿Š ‡ ‡ ˆåJ ‰ˆ È ÌöF>ý p Ûö¬ Øö¬ ¿cö¬ ™ö¬ Ðìö¬ µßö¬ö¬ ºö¬ íßö¬ö¬ šeö¬ ³ ö¬ äö¬ ïö¬Â BytesÁ õ £ Ä‘£ Å dataÁ£ Æ vtableÁ£ NÍâíŠá ïö¬¿¿ BytesMutÁ Àµ ™ Á‘™  capÁ™ Ãç™ )Ö1^ÔvÏ ¿c ª ª ¨� ®Ç ¯º °Ž- %ƒ_úæ÷í ¥¦ør “í ª ª ¨� ®Ç ¯º °Ž- %ƒ_úæ÷í¥¦ør áÌ° ሰ ¿c ž ž ‚L Ÿ“L žL ¡“1 ¢¹L û$瀩!/é ³ ¥ ¥ ÙL ¦éL §õL ¡FÃù^¿âa ³ Ù± ³ ˆ ˆ �1 ‰“1 Š¡1 Í<�k±¦É é Ù±£¯ é ø²£¯ ®²Ù± £®²Ù± ®²ø² £®²ø² E ª ª ¨� ®Ç ¯º °Ž- %ƒ_úæ÷íÌ°Ò°£
|
|||
|
|
ª ª ¨� ®Ç ¯º °Ž- %ƒ_úæ÷íÌ°°±¨š “í � � ç� „Ç µ
|
|||
|
|
@nð›î?�ª±°± ¤Ì° ¤ � � ç� „Ç µ
|
|||
|
|
@nð›î?�Ì°Ò° E‘¶
|
|||
|
|
� � ç� „Ç µ
|
|||
|
|
@nð›î?�Ì°°±ºµ ¿c‘¶ ¿c ª ª ŽM ±M ®Ž- ¯ÃM °ÓM ±Ò@ <za˜›5&LÌ°Ò° “í Ø Ø ¢‹ ÛÇ û õ]´']X#›ª±• ûÌ° û Ø Ø ¢‹ ÛÇ û õ]´']X#›Ì°• EѸ
|
|||
|
|
Ø Ø ¢‹ ÛÇ û õ]´']X#›Ì°¹¸ºµ ¿cѸ “í ¯ ¯ ܈ ²Ç ° @@r ·%ª±– ÒÌ° Ò ¯ ¯ ܈ ²Ç ° @@r ·%Ì°–
|
|||
|
|
¯ ¯ ܈ ²Ç ° @@r ·%Ì°›ººµ E ¯ ¯ ܈ ²Ç ° @@r ·%Ì°„¹ ¿c ¯ ¯ ܈ ²Ç ° @@r ·%Ì°Ò° ¿c ¶ ¶ ‰N ·˜N è ¸N è ¹ÝC è ºøC è »‘D è ¼ÝN è ŒãŸuZ Û¯¼ د¼ Š ¯¼ ¿c à à £O Äì@ è ź è ¸Ê]OÊjø ØÁ½ ¿c Ê Ë ÌüO Í Î�P ψ è
|
|||
|
|
½„üH;Ù6 Û�¾ Ø�¾ Š �¾ äÁ½ ïÁ½·® ³ Á½ “ “ “ “ “ ³ ¯¼ ¿c ÿ ÿ ±@ €Ò@ è )Ö/ 7 ÄcÙ¿ ¾ Ù¿ Ø Ö Ö ÊP ×ÜP ¹ ØïF ¹ ÙöP ¹ þ–T˜÷Yw ¿c¤À ™¤À Ðì¤À µß¤À¤À º¤À íߤÀ¤À še¤À ä¤À ï¤ÀÌ° ³ ¤À ¿c ê ë ìŠR í î¬R ïˆ ¾Ù3OÞ#]& ÄcîÁ é îÁßß Ä à… ¬
|
|||
|
|
ÑøÿËO Ÿ ¾ îÁ Ø ò ò ÐR óÜP à ôïF à õöP à ö�S à ÷˜S à å&ƒæ"ï9= ¿cƒÃ ™ƒÃ ÐìƒÃ µßƒÃƒÃ ºƒÃ í߃Ãà šeƒÃ äƒÃ ïƒÃÌ° ³ ƒÃ ¿c ˆ ‰ ŠµT ‹ Œ¬R �ˆ © o$ wbQ ÄcåÄ é åÄྠåÄ ¿c ‹ ‹ Á† �Ç ‘ ùr íÈBF¯ ¤ “í ‹ ‹ Á† �Ç ‘ ùr íÈBF¯¤ ªÌ° ªÐÅ
|
|||
|
|
�Æ ý
|
|||
|
|
EÐÅ “í Þ
|
|||
|
|
Þ
|
|||
|
|
Ùƒ á
|
|||
|
|
š~ ¬ â
|
|||
|
|
± ¬ ]3Ê� P¥
|
|||
|
|
£— …Ì° … Þ
|
|||
|
|
Þ
|
|||
|
|
Ùƒ á
|
|||
|
|
š~ ¬ â
|
|||
|
|
± ¬ ]3Ê� P¥
|
|||
|
|
£— |ØÇ ¯ØÇ “í ±
|
|||
|
|
±
|
|||
|
|
è€ ´
|
|||
|
|
�� ¬ µ
|
|||
|
|
± ¬ ËÜ{†9s 6¨ÀÇ Ø
|
|||
|
|
Ì° Ø
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
è€ ´
|
|||
|
|
�� ¬ µ
|
|||
|
|
± ¬ ËÜ{†9s 6 ¨™È ¯”É |”É ‚Ø ê ê ëåY ïˆ Ü ð‰ Ü ›Á#@‰Ë† ýºÇ“ ¿c …
|
|||
|
|
…
|
|||
|
|
þ} ‡
|
|||
|
|
š~ ÷ ˆ
|
|||
|
|
ìe ÷ ‰
|
|||
|
|
°~ ÷ ø`!þ ËŸ5“È “í …
|
|||
|
|
…
|
|||
|
|
þ} ‡
|
|||
|
|
š~ ÷ ˆ
|
|||
|
|
ìe ÷ ‰
|
|||
|
|
°~ ÷ ø`!þ ËŸ5ºÇ ¬
|
|||
|
|
Ì° ¬
|
|||
|
|
ÌÊ EÌÊ ¿c ¢
|
|||
|
|
¢
|
|||
|
|
ù £
|
|||
|
|
¡1 Œ ¤
|
|||
|
|
ã Œ ¥
|
|||
|
|
Âe Œ ¦
|
|||
|
|
Øe Œ §
|
|||
|
|
ìe Œ �T˜*¾Ý` ¿c ª
|
|||
|
|
ª
|
|||
|
|
„f «
|
|||
|
|
Ç Œ ±ÙÃ�2ø Œ"ôÌ |ôÌ ¿c ®
|
|||
|
|
®
|
|||
|
|
©f ¯
|
|||
|
|
Ç Œ �6†è¬>:~ Œ"¾Í ¯¾Í ¿c á á ä{ ã Ç ¹ Á:¤
|
|||
|
|
FÿÅ “í á á ä{ ã Ç ¹ Á:¤
|
|||
|
|
F¼Æ €
|
|||
|
|
Ì° €
|
|||
|
|
‰Î ¯‰Î E‰Î |‰Î ¿c ²
|
|||
|
|
²
|
|||
|
|
Ìf µ
|
|||
|
|
Ç Ú ¶
|
|||
|
|
õc Ú 42,k�ŠðÿÅ“ |±Ï `±Ï “í±Ï
|
|||
|
|
±Ï¥ ¿c »
|
|||
|
|
»
|
|||
|
|
œg ¼
|
|||
|
|
Ç E ¥Ëf´m Œ"¬Ð ¿c ¿
|
|||
|
|
¿
|
|||
|
|
Àg Á
|
|||
|
|
Ç l£¹Ð„‘¼ ý Œ" ¿
|
|||
|
|
¿
|
|||
|
|
Àg Á
|
|||
|
|
Ç l£¹Ð„‘¼ 8 «½ H H è IÇ ,|ðÌ�_çu ¬½ßÑ “í Å
|
|||
|
|
Å
|
|||
|
|
÷g Ç
|
|||
|
|
¥ È
|
|||
|
|
œ* åíäýøsL ý å
|
|||
|
|
Ì° å
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
÷g Ç
|
|||
|
|
¥ È
|
|||
|
|
œ* åíäýøsL ý “í ê
|
|||
|
|
ê
|
|||
|
|
�k ë
|
|||
|
|
œ* ì
|
|||
|
|
¥ uµËc¹W¶ ƒ Ì° ƒ ³Ó ¿cßÑ ØßÑ Œ"ßÑ ³ ßÑ ¿cíÒ ‚ØíÒ ¿c³Ó ‚Ø³Ó “í ‡ ‡ ‡m Š ¶m ‹ œ* ËÈ#j }´€ ýÀÇ ® Ì° ® ‡ ‡ ‡m Š ¶m ‹ œ* ËÈ#j }´€ ý™È ‚Ø·Õ “í ´ ´ ƒp ¶ ¶m · œ* ý�Œ¢©Û‹†™È Ô Ì° Ô ´ ´ ƒp ¶ ¶m · œ* ý�Œ¢©Û‹† — ‚ØÛÖ ¿c Ù Ù Ú ¹r Ü ˆ � ùį¦ib\Ì° Äc¬× ¾ ¬× ¿c à â ã �s ä ˆ � å æ ¦s ç è ¼s é ˆ � ê ë Üs ÖD0Ÿƒœ{ïÌ° ¿c ï ï „t ñ žt � ò º � ó ´t � ˆõæ±ÛÕTÌ° ¿c ÷ ÷ ø Øt ú ˆ � ½„�íBR\²Ì° ØøØ
|
|||
|
|
øØÌ° E Ø Ø € Ù• É Ú¦ É ó¹ßjć' ØžÚ ¿cžÚ à žÚìOìO SemaphoreÁ íO ll_semÁ‘G ÈèGEä b> ‚Ø ü ü Þ ÿ‡ î îÎRŒ�\7ø 8ª± � ¾Û ¿c¾Û Œ" ž ž ™" ¡± î M&iñ.iãÏ ™È ¿c þ � ‚ ¸u ƒ ˆ „ … Ñu † ˆ ¤-íÂâªE �ºÇ ØÑÜ ‚ØÑÜ |ÑÜ `ÑÜ •ÑÜ ¯ÑÜ EÑÜ
|
|||
|
|
ÑÜ› Œ" ð ð ñØ' óˆ é Åxk�„\Ì° ‚Ø ð ð ñØ' óˆ é Åxk�„\“× “í — — óv š ± œ ÇЉª@ÅÉt ýÀÇ º Ì° º — — óv š ± œ ÇЉª@ÅÉt ý™È ‚ØËß “í À À Éy  ± œ €În‡`—m™È Ü Ì° Ü À À Éy  ± œ €În‡`—m“× ‚ØÛà ¿Ì° Š ‡Â ¶Õ Ê‹ ‡¿ ¶Ò ÊŒ ‡À ¶È ÃÓ ÊÚ Öø òN H¼ ï ç Ø‹ þ Ž ‡± ª£ žï �² ª« Øã ¯½ ¶Æ ÃРʱ ÿÜ Öð êú òŽ ˆŽ ‹Š
|
|||
|
|
…
|
|||
|
|
¨
|
|||
|
|
¢
|
|||
|
|
¬
|
|||
|
|
ª
|
|||
|
|
°
|
|||
|
|
®
|
|||
|
|
ä á ·
|
|||
|
|
²
|
|||
|
|
½
|
|||
|
|
»
|
|||
|
|
Â
|
|||
|
|
¿
|
|||
|
|
L He Å
|
|||
|
|
l ê
|
|||
|
|
Ý Ù ì à ô ï û ÷ é Ø• ü‡ þ � ‡Þ Öü ò’ ‡à Öþ ò“ ‡á Öÿ ò• ‡ã Ö� ò— ‡å Öƒ ò™ ‡ç Ö… òœ ‡¨ ¥‹ ž� ˆ� ï ¶Ö Öý òR HÒ ‡ˆ ÃÌ Öó òÖ ‡Ù ‡Œ ÃÒ Öù òÜ ª �÷ ØÎ ¯§ ‹� Þ
|
|||
|
|
Ô
|
|||
|
|
±
|
|||
|
|
©
|
|||
|
|
…
|
|||
|
|
ý á €
|
|||
|
|
²
|
|||
|
|
â
|
|||
|
|
Å
|
|||
|
|
� ê
|
|||
|
|
ª ‡ Ñ ´ ¶ — Ù À â ä ª� ž‘ ˆÚ ê� ˆ“ ¥— ¥• ¥™ ¥› ªá �� ØÞ ¯¨ ‹‡ …
|
|||
|
|
Ó á ä ØØ þ ¥ ªæ �¢ ØÕ ¯ ‹�
|
|||
|
|
²
|
|||
|
|
¿ ï Ý þ ¥ § �ü þ ØÓ Õ ¯”•–—˜ ³ ÿØ êÿ ˆœ Ù µ ÿÜ êƒ ˆŸ Ù « ‹† ˆ Þ
|
|||
|
|
¿ Þ
|
|||
|
|
Ø ±
|
|||
|
|
® ª
|
|||
|
|
× á õ ²
|
|||
|
|
 þ à Þ
|
|||
|
|
Ð ±
|
|||
|
|
² ®
|
|||
|
|
Ì á Ð þ Ù
|
|||
|
|
Û
|
|||
|
|
±
|
|||
|
|
ñ êh Å
|
|||
|
|
q ê
|
|||
|
|
x ‡ } ´ � ü¼ þ ú ð — ¶ À
|
|||
|
|
¯
|
|||
|
|
…
|
|||
|
|
¬ ª
|
|||
|
|
° ®
|
|||
|
|
»
|
|||
|
|
¿
|
|||
|
|
P H§ žô ð�
|
|||
|
|
ƒ
|
|||
|
|
á ú ²
|
|||
|
|
Æ þ J HK Hæ
|
|||
|
|
è
|
|||
|
|
Å
|
|||
|
|
„ † ê
|
|||
|
|
¯ ± ‡ Õ × ´ ë Ø“ üË þ » ½ — Ý ß À  Š Ä
|
|||
|
|
ÛØ
|
|||
|
|
¿c"D™êÐìµßºíßše³ ä= ï “í# ápé
|
|||
|
|
£E
|
|||
|
|
? ¤8 û
|
|||
|
|
Ò
|
|||
|
|
“
|
|||
|
|
Äc¾ ª …
|
|||
|
|
|
|
|||
|
|
¯* Ø
|
|||
|
|
#‚Ø
|
|||
|
|
|
|||
|
|
¬
|
|||
|
|
BŒ"
|
|||
|
|
€
|
|||
|
|
-`
|
|||
|
|
«½¬½ å
|
|||
|
|
ƒ
|
|||
|
|
®
|
|||
|
|
Ô
|
|||
|
|
à
|
|||
|
|
� • º Ü
|
|||
|
|
¿
|
|||
|
|
_ÁD± ± $µ 5 8 6 j ü‘) ‡ ,© £ / _Á _Á _Á _ÁLº 5 B èÆ Â ü“1 í –ð ,² èï � èï • 6 b",;\n\r"Á $ì 5 B –ð ï üÅ, î –ð ,ä ñ Š ñ ’ 6 b","Á _Á _Á _Á
|
|||
|
|
ü« Ï é“ÈïÏ “Ø“Ø ”ØÎ •Øˆä o
|
|||
|
|
³Î¢½ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
à“È ïÏ Á Î
|
|||
|
|
‰Ì €ô ŠÚ †ô ¤¸ ê “ÈïÏ (ŒÍ
|
|||
|
|
ˆØ ê ê ëåY ïˆ Ü ð‰ Ü ›Á#@‰Ë† “ÈïÏ … 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 ‚ þ� éLŠ €ô ìe’ †ô éL® ìe° û7 “õ � L ó œØ ( 3
|
|||
|
|
é B % , œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã ¯ ßò ¸ Èû Á É “õ; û « T X Æ ²ý „¾„¾ Œý †¾‰ ˜X $ ]È=„kt•Ýò C Èû L €ô F †ô E“õ 6 “õ d ²ý H €þ Q ´ö Z Èû c k ©ó Èû } ¶ Ýò ¿ þÊ éLÇ €ô ìeÏ †ô éLë ìeí ût “õ � ‰ 0 Œõ
|
|||
|
|
®ö âö éLìe“õ¾ û ƒ Ö Ú 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
|
|||
|
|
|
|||
|
|
ˆØ ‡ ‡ ‡m Š ¶m ‹ œ* ËÈ#j }´€ “× 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 Å
|
|||
|
|
Å
|
|||
|
|
÷g Ç
|
|||
|
|
¥ È
|
|||
|
|
œ* åíäýøsL À ׇ ³ “× « ÅŠ 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|Â
|
|||
|
|
Ö>Ö> OwnedPermitÁ Ø> chanÁ¹> óë tÏ<
|
|||
|
|
Ì°¬×ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÇ>Ç> ©f É>²±¹> B“dí XóÌ° 4 B ¸¯ Û² Û² $‚
|
|||
|
|
Û² Tü � ùØž"#ù½ž"#
|
|||
|
|
°c ùÓµ.# Zœ† 9 4–
|
|||
|
|
Û²Û ³ ü¡
|
|||
|
|
# lµ
|
|||
|
|
|
|||
|
|
’?Ì° 4¡
|
|||
|
|
|µ
|
|||
|
|
(ºÒ
|
|||
|
|
|
|||
|
|
ˆØ”?Ì° ðò Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
”²óMóM ôM SendErrorÁ öMˆ ]SqÍOKx ³ î È ø»¡
|
|||
|
|
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 Û² žt… ûs íµ � ˆ •
|
|||
|
|
¦
|
|||
|
|
´
|
|||
|
|
œØ Ê
|
|||
|
|
Õ
|
|||
|
|
|
|||
|
|
¤ ä
|
|||
|
|
d _ À Ç ´�
|
|||
|
|
²± Èû ' Û². íµ; çû ö À Ä + œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃƱ º „¾„¾ Œý †¾‰ ˜X $ ]È=„kt•°± õ Èû þ ô ³ )
|
|||
|
|
íµ à íµ
|
|||
|
|
þÁ ò ÌÂ û ð·
|
|||
|
|
Èû
|
|||
|
|
|
|||
|
|
�¶ R Èû '
|
|||
|
|
Œº H ¦ úà Ï
|
|||
|
|
Ʊ � ‰ °± ’ þ� ç¡ Û² ç´ Û² žtì
|
|||
|
|
ûÚ íµ � ï ü à´^ ¸µ æµÝ
|
|||
|
|
ê·ä
|
|||
|
|
£¸ë
|
|||
|
|
íµ% ú¹æ þºoíµ: çÛ²G Ì°“?[
|
|||
|
|
çû ß ã 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 ê ê ëåY ïˆ Ü ð‰ Ü ›Á#@‰Ë† ºÇ¿Ê ‚ ºÇ � ¿Ê ˜ Ÿ Ü— Ù Ì° Ú ) ¬× 5 ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÌ° ‚ ‰ $þ à Ì° ã ) ÿ× 5 ³ = D \¢ à Ì° è ) ÿ× 5 ”² = D Ôº ÷ Ì° ø ) ÉÙ 5 ü ü Þ ÿ‡ î îÎRŒ�\7ø Ʊ 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Ž- <Z + p q Ÿ 8ä Dr z ž 8 docsrsÁ 4{ $ � 8Ó ƒ † � 8â ‡ Š œ 8» <‹ “ 7Ž- <• , 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Ž- <þ + • – Ú 8ä D— Ÿ Ù 8åà 4 $ ¦ 8Ó ¨ « Ø 8â ¬ ¯ × 8£ ° ³ Ö 8» <´ ¼ 7Ô ,¾ $ Ã 8» <Å Í 7Ž- <Ï , è 8÷ $é
|
|||
|
|
÷ œ‚4� – ½ œ « , � ž © , Ÿ 8÷ $ & ¤ 8÷ $¥
|
|||
|
|
ª * ° » , º » ´ + É Ê Þ 8â Ë Î Ý 8» <Ï × 7±M $Ù + ì í ˜ 8ä Dî ö — 8åà 4÷ $ ý 8Ó ÿ ‚ – 8â ƒ † • 8» <‡ � 7±M $‘ , ¦ 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Á $– �ÉîœgLa »
|
|||
|
|
…Àgdw ¿
|
|||
|
|
†èŒ… H ‡÷g̘ Å
|
|||
|
|
ˆ�kô· ê
|
|||
|
|
‰‡m¼þ ‡ ‹ƒpä— ´ Œ¹rlÐ Ù Ç„tTß ï È€ l™ Ø íÞ ŒÑ ü «´ ”$ HÅ
|
|||
|
|
ê
|
|||
|
|
‡ ´ É
|
|||
|
|
í
|
|||
|
|
Œ ¸ K Ú
|
|||
|
|
†J > Ø'lð
|
|||
|
|
ð ? — FutureÁ4‘
|
|||
|
|
‚Ø @Œý ¨
|
|||
|
|
„¾ Ak<¾
|
|||
|
|
Ì� C·$Ç
|
|||
|
|
œØ DœgLÚ
|
|||
|
|
»
|
|||
|
|
EÀgdô
|
|||
|
|
¿
|
|||
|
|
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Í % % ¸ &Ç 'Ó ’Å Rš§’ ’Å Rš§’ &'œÜ,Ü % % µ>µ> ¤ ·>Ç£> ¸> poisonÁ£> ¹>ç£> Ë»™z™g— + + ù ,… -’ .£ /² 0Å T¼d˜ÐórÓ Ôõ,õ % % çNçN NotifyÁ èNº¯D éN waitersÁ¯D %€-O l“ Üÿ)* ܧ µ Üÿ ( (
|
|||
|
|
) üòCD€ ë ëÜÿ “O“O NotifiedÁ •O notifyÁ¯D –Oº¯D —O notify_waiters_callsÁ¯D ˜O waiterÁ¯D lÖg™�”² ë ( ‰ (
|
|||
|
|
* $Šdâ ,é ˆ� T¼d˜ÐórÓ ,-./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ìe÷< ®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());Á ,Ó
|
|||
|
|
}Á <Ù
|
|||
|
|
```Á Œì
|
|||
|
|
ßÑ ,|ðÌ�_çu I Qü„
|
|||
|
|
|
|||
|
|
,„
|
|||
|
|
H H Ý…ü¨
|
|||
|
|
1
|
|||
|
|
ßÑ üÝ
|
|||
|
|
4
|
|||
|
|
ßÑ üÊ +
|
|||
|
|
ßÑM Àc M üü D
|
|||
|
|
ÿ
|
|||
|
|
ù ú û ùßÑ ú c c ˆ ¢cµ
|
|||
|
|
` £cìe ` à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»;
|
|||
|
|
� �ßÑ Å
|
|||
|
|
Å
|
|||
|
|
÷g Ç
|
|||
|
|
¥ È
|
|||
|
|
œ* åíäýøsL � 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
|
|||
|
|
‚ ‚ßÑ ¿
|
|||
|
|
¿
|
|||
|
|
Àg Á
|
|||
|
|
Ç l£¹Ð„‘¼ ‚ 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ìe ` à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ìe ` àB¤GS
|
|||
|
|
Œé¢ l Ù\
|
|||
|
|
l
|
|||
|
|
m $Ú\
|
|||
|
|
± à\
|
|||
|
|
üä]#
|
|||
|
|
³Óop üŽ^5
|
|||
|
|
‘^
|
|||
|
|
ßÑ³Ó n n
|
|||
|
|
o ¥”•^
|
|||
|
|
üÛcv
|
|||
|
|
Tåc
|
|||
|
|
� �ßÑ “O“O ¼‚ •OÍ‚¯D –Oº¯D —O낯D ˜O‹ƒ¯D lÖg™�”² 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 Ö> � –©f4› Ç> � —Þ Œ¯ ü � ˜ «” ½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ìe ` àB¤GS
|
|||
|
|
™é¢ œ µ œ
|
|||
|
|
žÌ°$¶ × ¼ üš: ¥ Ïç Ÿ ¿cÌ° T¢ ¬× üŠ k œ“ � ۲̰ £ ¥ ¢ ¢ Ïç §
|
|||
|
|
¡Ì°ç$V ø¿Í ( ¡ ¡ ²± Íì“í & ‚Ø“í 5 “íƒØ ƱG ÷íM †îS •îY ¡ �^ ¡ûÈ ¤ •É ¤ ªÉ ¤ ¾É ¤ Ï� ¤ ¤ ¡ ²± í
|
|||
|
|
¡š� ¥ ²� ¥ Ï� ¥ ¥ ¡ Œº¼â \ç � ý § ¥ ¨ ¨ § Í쪱 ÷ ü ü Þ ÿ‡ î îÎRŒ�\7ø ýÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ö>Ö> ž± Ø>²±¹> óë tÏ<
|
|||
|
|
ª± Ù Ù Ú ¹r Ü ˆ � ùį¦ib\ª±ó õ÷ Üð ¥ ª ª Ïç õ ÉÙ«
|
|||
|
|
”Ò ,Õ � ÉÙ © ©
|
|||
|
|
«Ì°,² «ûÈ ¬ •É ¬ ªÉ ¬ ¾É ¬ Ï� ¬ ¬ « öÌüÖ! ¥ ® ® Ïç Û ÌìÌ° $Þ ÉÙ¯°± "$ „© ¬ � ÉÙ
|
|||
|
|
¯Ì°üÏZ $Ò � š › œ šÉÙ ›Ì�Ì� k Î�Ó¸� Ï�íú¸� Ð�†û¸� Ñ�—û¸� Ò�¬û¸� f'EwÚ]¾å œ‘È ×
|
|||
|
|
°Ì°$Ü ùÒâ üñ, ô � � �ÉÙÛ² ø
|
|||
|
|
±Ì°$ý žt4ƒ Ü€ ¥ ³ ³ Ïç … ¸ô$ˆ øØ´µ¶·¸¹º» (* üÆ % ü¢ Creates a new `PollSender`.Á Í ³øØ ² ²
|
|||
|
|
´Ì°žt4Ñ ü’ $ 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ìe ` à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.Á Œú ý ý ¥ þ ý þ ¤ð � ü ü Þ ÿ‡ î îÎRŒ�\7ø ýª± îÎRŒ�\7ø ÿŒ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� î Æ Æ ü ü Þ ÿ‡ î îÎRŒ�\7ø ý‘Ý™ÈÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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ìe ` àB¤GS
|
|||
|
|
Óé¢ • Ç •
|
|||
|
|
— 8ª±$ȱ Îü¹…l¼ î „¾„¾ Œý †¾‰ ˜X $ ]È=„kt•�� ž¿Í ¡ˆˆ ¢‰ˆ l }.xÏÌ°†Ò°—Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ò° ¥ ™ ¦ š › — œ œ › ™ š ÎìÌ° Ê ÍìÒ° Õ Íìàê Ø Íì�ê Û –"�ê�� ž¿Í ¡ˆˆ ¢‰ˆ l }.xÏÒ°† œª �ê€ì˜" àê ¼
|
|||
|
|
˜Ì°Ò°àê�ê‡ ,Þ new_valueÁLò callbackÁD€åç áã Ýß ÙÛ ¶ ˜š� � ²� � Ï� � � ˜ �Ì°Ò°àê�ê àê Ì° Ò°�êüÀ#& TÇ#î Ÿ — Ÿ ÍìÀÜ Ò# ÆÚ Õ# –"™È lØ# ™È ˜" ÀÜ ä#’Ü M&iñ.iãÏ ¡ ªRT WY ”í# í#î ž ž ÃÛÃÛ ¶È ÅÛ»¬ „ µÜÀ,�%*™Èü„$* £ — ¤ £ ¤ »ï ›$ ÆÚ Œ$ ¨ïl�$ �ï ‰$’Ü¥¦ +- ¤µ$ ¸$ î ™È’Ü ¢ ¢
|
|||
|
|
¥Àܙȱ ¼$”�%$’% î ’ÜÀÜ ¢ ¢
|
|||
|
|
¦ÀÜ™È$—%ü¥&3 ¨ — © © ¨ »ï ¼& ÆÚ & ¨ïl°& �ï ª&’ܪ �" ª 02 ”ß&$â& Ô Ô’Ü § ç& §
|
|||
|
|
ªÀÜ™È$ì&üà ´~t� ü # Module defining an Either type.Á 4¥ þ ßö4; ‚Ø ¬ ® SeekFromÁDK ñL ¬ ¯Œý ^ „¾ ¬ °k<n Ì� ¬ ²·$w œØ ¬ ³ AsyncBufReadÁd‘ ` ¬ µ 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¸u $ò ö ø 8· ÷ *ú 8Œý ý '€ 8ð l‚ � ‘ 8· � ’ , “ 8¢÷ 4” š ¥ , › œ ¢ , � 8À $ž $ £ ¤ $ ¦ 8 $¸ '¼ 8Ñu ,¾ à Š8½ Ä *Ç 8Œý Ê 'Í 8ð lÏ Ü Þ 8½ Ý ß , à 8¢÷ 4á ç ò , è é ï , ê 8À $ë $ ð ñ $ ó ü–a � ½ £ ¾ ¿ ¾ ¿ ½ ™ÝƒØ àêTÐ ºÇƒØ àêTë Óë ¡ ‚Ø™Ý ”É Íì™Ý › ‚ØºÇ ”ä ÍìºÇ žÑÜÀÁ ƒØ „Ø Á >@ )+ z| \þ4ƒ ¼ ¼ àêü”I$— Õ Ö ×„¾„¾ Œý †¾‰ ˜X $ ]È=„kt• ÕÑÜ ÖÌ�Ì� k Î�Ó¸� Ï�íú¸� Ð�†û¸� Ñ�—û¸� Ò�¬û¸� f'EwÚ]¾å ×œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÑÜ ƒØ ¼ ¦ ¼
|
|||
|
|
Á™ÝºÇàê$œùÒ²ü�O � à £ Ä Ã Ä ¼þ ” Þþ — |™Ý L |ºÇ LÔÑÜÅ } Å 8: =? üå‚Lè Ø Ù Ú Û Ü„¾„¾ Œý †¾‰ ˜X $ ]È=„kt• ØÑÜ ÙÌ�Ì� k Î�Ó¸� Ï�íú¸� Ð�†û¸� Ñ�—û¸� Ò�¬û¸� f'EwÚ]¾å Ú Ûåå áõ çìeâ è filledÁâ é initializedÁâ á‹™wP Ó ÜœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÃÂ Â … Â
|
|||
|
|
řݺÇ$ûùÒ™ìe ·ü£X � Ç £ È Ç È ¼þ ¨ Þþ « `™Ý dÙ `ºÇ dîÑÜÉÊ a b Ê É 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;(*W¬ lÌ ¥ ò ò Ïç Ú …Þ Åxk�„\ ñ ó ÛÛ…Þ ö¬T é ÛÛ…Þ ð ð
|
|||
|
|
ñÌ°oq tÝ é ð ð ÛÛüï ! ¥ õ õ Ïç ô …Þö �" ö ”—
|
|||
|
|
$š
|
|||
|
|
‚ ‚…Þ ô Ÿ
|
|||
|
|
ô
|
|||
|
|
öÌ°$¤
|
|||
|
|
Ä¥ ¥ ø ø Ïç ª …Þù
|
|||
|
|
üÄ # Ò Ì°…Þ ÷ ÷
|
|||
|
|
ùÌ°Ç,Ö ü™ + — û û ÏŠ ž ›È4¡ ÃÞüý ƒØ „Ø ý $& \Ë 4Ð ú ú ɇüé I$ì ƒ „ …„¾„¾ Œý †¾‰ ˜X $ ]È=„kt• ƒÃÞ „Ì�Ì� k Î�Ó¸� Ï�íú¸� Ð�†û¸� Ñ�—û¸� Ò�¬û¸� f'EwÚ]¾å …œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÃÞ ƒØ ú û ú
|
|||
|
|
ý“×$ñ ùÒ‡
|
|||
|
|
4• ýš� þ ²� þ Ï� þ þ ý þ“× ÃÞ “× dC »±Mt »Ž-Œ.ü #ü. DGè�’‡õL | ÿ �ÂõT ¯ ÿ ‚áõ<' å ÿ ƒ BufÁ > ÿ … BufMutÁ4C ™ ÿ †±M$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•
|
|||
|
|
|
|||
|
|
�Ì°ïϱM¢
|
|||
|
|
ùÒ·
|
|||
|
|
ìe Ñ
|
|||
|
|
Z\ VX üÜ“ ü¯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õ ïÏ �
|
|||
|
|
’Ì°ïϱM—ùÒ¬ìe ÆQS VX ¬öDüÿ D° ’ ’ ìaŸDð“–‡ŠtÉ ü R O An extension trait for Futures that provides a variety of convenient adapters.Á 4Ñ œ¿óvÜ� — › »Éyü¬ À › ¼ßö4á ‚Ø › ½èŒû H › ¾ ‡ÜT ¼X›— À › à ßö4 ‚Ø œ žŒý ( „¾ œ Ÿk<8 Ì� œ ¡·$A œØ œ ¢Û÷\b œ £èŒ‚ H œ ¥ ‡‡m¼• ‡ œ ¦ ‹ƒpä® ´ œ § Œ t¶D#¥ü1—™†ˆìPw\thjTV?Aü¨6 ý © — ª ª © ÆÚ ± ×Ú4´Ëß« üåO ó ¹ý™ÈËß ¨ ¨
|
|||
|
|
« ý™È¥”÷œ*4¢¢ «š� ¬ ²� ¬ Ï� ¬ ¬ « ¬ ™È ‡ ‡ ‡m Š ¶m ‹ œ* ËÈ#j }´€ ™È ׇ™Èüó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÷ $–
|
|||
|
|
¨ \ç »Ž-ˆ PÈ J <ë ” ,
|
|||
|
|
z % , # , 8 argÁ & 8¯ !
|
|||
|
|
$ *' * w + 4 5 N 8â 6 9 M 8» <: B 7ó, LD 8ó, <X '_ 8‚- ,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Ù£¯ÃÂ Ò ‹ Ò
|
|||
|
|
Õ $� ìe – üò
|
|||
|
|
" ö¬×Ø ñ ò Ø T› , Ö Ö ÃÂü¸N 4» — ˜ —ö¬·® ˜£¯ç† Ö Â Ö
|
|||
|
|
Ø $Ç ç$Í ìe Ú üÙ% ö¬ÚÛ ñ ò Û T… ,Š Ù Ù ÃÂü¢Q 4¥ ™ š ™ö¬£¯ š£¯ç† Ù ¬ Ù
|
|||
|
|
Û $± ç$· ìe Ç ì‰cU\©c <cÇäç�4 � Ý Þ ù‡õL+ | Ý àÂõT6 ¯ Ý á®DO ¿ Ý â±Mb ¦ Ý ã¤jL VXFH|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ö £ ô €±M‹ ¦ ô �Œý � „¾ ô ‚¢,² ¥‚ ô „k<¹ Ì� ô …·$ œØ ô †ô=ô(/¤M Lg|�ù”¥éì½Ú\àÌμ¾<†¯l“ŸL¦Ž�|~jlì‘„—ô äí Tÿ ø² Í<�k±¦É ‰ŠÜ�4› ˆ ˆ £¯ü±'¬¼ ˆ ˆ ÔÒ Ù±Œ ´ Œ ¤ó<ö Ù± ‹ ‹
|
|||
|
|
Œ Üà ø²Ž ´ Ž ¤å <è ø² � �
|
|||
|
|
Ž ü’ ! Ù±� ë � üº %$½ £¯Ù± � �
|
|||
|
|
� “14Æ üþ
|
|||
|
|
" ø²’ ë ’ ü§%$ª £¯ø² ‘ ‘
|
|||
|
|
’ “14³üÅ# ®²” ¢ ” ôï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Ǫ�…ã.< ä µ ¶Ð/<? ï µ ·¨�Th ª µ ¹ÙLDt ¥ µ º‚LL~ ž µ »�1T‰ ˆ µ ¼×¡4© E µ ½‡õLÁ | µ ¿ÂõTÌ ¯ µ À®Då ¿ µ ÁÀä$�
|
|||
|
|
µ ÂÛ÷\� µ Ã× ³ ¤, µ ıMÁ ¦ µ ÅŒý Ó „¾ µ Æk<è Ì� µ È·$ñ œØ µ Éô gô( YÌL JM<?.1 #¤› 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Á ” Ì°Ò°‘¶ Ê Ê
|
|||
|
|
ÍÌ°Ò°Ç,˜ Ž-,¢ üØ&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ß& Ì°Ò° ‘¶ Ê Ê
|
|||
|
|
ÎÌ°Ò°Ç,í& Ž-,÷& °~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 ‘¶�ê � � ç� „Ç µ
|
|||
|
|
@nð›î?�Ì°” Ê” Ö — × Ö × Ê Íì»’ �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ìe ` àB¤GS
|
|||
|
|
Íé¢ ï i ï
|
|||
|
|
òÌ°Ò°$¡i ± §i äðp ¥ ô ¦ õ ô õ Ïç õp Âë øp ¥·ö üÀqT ü“q( % Create a new, default, `FramedParts`Á Çq Ì°Ò°¥· óš ÷ ÷ ó Íìš Ëq ïҰδ T‰r
|
|||
|
|
ö̰Ұδ±MÎq Ž-,Õq 9; d•e|``p`s`|»e \¿eÇØܨ�T ª û ý‚LL, ž û þã.<J ä û ÿ ëס4f E û €‡õL} | û �®D” ¿ û ‚Àä$°
|
|||
|
|
û ƒÛ÷\Ì û „× â ¤, û …Œý õ „¾ û †k<Š Ì� û ˆ·$“ œØ û ‰ŽM\¦ ª û Š úÌ ¬< ¤X í¤r Þ|� Д¢ Àìº ±DÝ ¢lë ’Lþ ƒ…qs”Ÿ cÜì ¥ Œ • � Œ � Ïç ñ Í섹 ô ѸŽ��‘’“”•–™š›œ @B <> üË 4 üŽ 8 5 Creates a new `FramedRead` with the given `decoder`.Á Ò Ì°„¹Ñ¸ ‹ ‹
|
|||
|
|
ŽÌ°„¹Ç,Ö ¶.<à üª O ü½ R O Creates a new `FramedRead` with the given `decoder` and a buffer of `capacity`Á Œ” initial size.Ál± Ì°„¹ Ѹ ‹ ‹
|
|||
|
|
�Ì°„¹Ç,¿ ¶.<É °~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Á Äé ¥�\� Ѹ�ê Ø Ø ¢‹ ÛÇ û õ]´']X#›Ì°»’ ‹” — — ˜ — ˜ ‹ ð’ ™ äë œ –"�ꄹ tÖ �êÕǘ" »’ ã
|
|||
|
|
–Ì°„¹»’�ê$Ÿ Ø ¥ ]_ bd ü•"6 üÖ!: ¼Ã|œ" Ó„¾„¾ Œý †¾‰ ˜X $ ]È=„kt• ÓѸ Ó„¹ ‹ ¶" ‹
|
|||
|
|
™Ì°„¹$¬" ü¶#& ü†#+ á”\½# Ô ÔѸ Ô£¯ ‹ É# ‹
|
|||
|
|
šÌ°„¹$Ê# üÃ$2 ü‹$3 ÿ•|Ê$ Õ ÕѸ Õ£¯ ‹ Ú$ ‹
|
|||
|
|
›Ì°„¹$ß$ ü©&, ü¨%N K Consumes the `FramedRead`, returning its underlying I/O stream, the bufferÁ üû%) ¬žT°& Ѹ ª ª ŽM ±M ®Ž- ¯ÃM °ÓM ±Ò@ <za˜›5&LÌ°„¹ ‹ ‹
|
|||
|
|
œÌ°„¹$»& üì(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ìe ` àB¤GS
|
|||
|
|
åé¢ « ï1 «
|
|||
|
|
®Ì°„¹$ð1 ± ö1 ìÔe v„ôe døeǯ³Ð/< ï ° ±¨�TD ª ° ³�1TP ˆ ° ´×¡4p E ° µÂõT‡ ¯ ° ¶®DŸ ¿ ° ·Àä$»
|
|||
|
|
° ¸Û÷\× ° ¹× í ¤, ° º±Mû ¦ ° »Œý � „¾ ° ¼k<¢ Ì� ° ¾·$« œØ ° ¿ŽM\¾ ª ° À úô -Ì( !¤b ¬| ö|˜ æ” ÖìÅ ÇDè ¸<ö ©lƒ ™L– ŠŒxz”· jä» ¥  – à à  Ïç À Íìæº Ã ³ºÄÅÆÇÈÉÊËÌÏÐÑÒÓÔ FH BD üœ 5 üÞ9 6 Creates a new `FramedWrite` with the given `encoder`.Á £ ̰溳º Á Á
|
|||
|
|
ÄÌ°æºÇ,§ ·/<± ü� P ü“ S P Creates a new `FramedWrite` with the given `encoder` and a buffer of `capacity`Á Œë ³ºlˆ Ì°æº ³º Á Á
|
|||
|
|
ÅÌ°æºÇ,– ·/< °~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 ·%Ì°»’ Á” Í — Î Î Í Á ð’ ½ äë À –"�êæº tû �êó˜" »’ ˆ
|
|||
|
|
Ḭ̀溻’�ê$Ã Ø É ]_ bd ü»!6 üü : “ï|Â! 넾„¾ Œý †¾‰ ˜X $ ]È=„kt• 볺 ëæº Á Ü! Á
|
|||
|
|
ÏÌ°æº$Ò! üÝ"' ü¬", ¥—dä" ì 쳺 죯 Á ñ" Á
|
|||
|
|
ÐÌ°æº$ò" üì#3 ü³#4 Ę„ó# í í³º í£¯ Á „$ Á
|
|||
|
|
ÑÌ°æº$‰$ üø$, üÒ$! 뙬ÿ$ î  Á •% Á
|
|||
|
|
ÒÌ°æº$–% ü‡&< üá%! ôšÌŽ& ï ﳺ Á ¨& Á
|
|||
|
|
ÓÌ°æº$& ñ›D³& üŽ(, üŒ'O L Consumes the `FramedWrite`, returning its underlying I/O stream, the bufferÁ üà') ¬žT•( ³º ª ª ŽM ±M ®Ž- ¯ÃM °ÓM ±Ò@ <za˜›5&LÌ°æº Á Á
|
|||
|
|
ÔÌ°æº$ ( üÑ*v ¥ Ö š × – Ø Ö × Ø Ïç Ö* þß Ù* Í웺 Ü* ™ÚTŠ+ ºµ T�+ é ›ººµ ñà|·+ òºÙÚÛÜÝ
|
|||
|
|
Û Ý Ü Ú ŠŒ �‘ ‹� TÎ+ ,Ó+ Õ Õ �üüê+Z Tí+ ð ñ ò„¾„¾ Œý †¾‰ ˜X $ ]È=„kt• ðòº ñÌ�Ì� k Î�Ó¸� Ï�íú¸� Ð�†û¸� Ñ�—û¸� Ò�¬û¸� f'EwÚ]¾å òœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
òººµ Õ ‚, Õ
|
|||
|
|
ÚÌ°ºµ›º$ø+ ùÒŽ, üþ,G T�- 󄾄¾ Œý †¾‰ ˜X $ ]È=„kt• óòººµÍÿ Õ –- Õ
|
|||
|
|
ÛÌ°ºµ›º$Œ- ÷$¢- ü
|
|||
|
|
` £cìe ` à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
|
|||
|
|
ö¨ ü�U?
|
|||
|
|
–© üÝU*
|
|||
|
|
ïÓ <ˆV
|
|||
|
|
±È <�V
|
|||
|
|
ן ˜V
|
|||
|
|
ú üœV0
|
|||
|
|
µª ÍV
|
|||
|
|
ú \ÑV
|
|||
|
|
И ÔÝV
|
|||
|
|
çÇ üøV2
|
|||
|
|
ýÔ ü«W2
|
|||
|
|
/ | \xCA | \x00\x0F | \xFE | Hello world |Á üÞW2
|
|||
|
|
õÕ ‘X
|
|||
|
|
ú ¤•X
|
|||
|
|
¼Ö ôªX
|
|||
|
|
ÙÖ ôÉX
|
|||
|
|
€× ôèX
|
|||
|
|
§× <‡Y
|
|||
|
|
ן �Y
|
|||
|
|
ú ü“YI
|
|||
|
|
F Similar to the example above, the difference is that the length fieldÁ üÝYJ
|
|||
|
|
G represents the length of the entire frame instead of just the payload.Á ü¨ZJ
|
|||
|
|
G The length of `hdr1` and `len` must be counted in `length_adjustment`.Á üóZI
|
|||
|
|
F Note that the length of `hdr2` does **not** need to be explicitly setÁ ü½[L
|
|||
|
|
I anywhere because it already is factored into the total frame length thatÁ üŠ\!
|
|||
|
|
is read from the byte stream.Á ¬\
|
|||
|
|
ú „°\
|
|||
|
|
|
|||
|
|
## Example 7Á Á\
|
|||
|
|
ú üÅ\J
|
|||
|
|
G The following will parse a 3 byte length field at offset 0 in a 4 byteÁ ü�]C
|
|||
|
|
@ frame head, excluding the 4th byte from the yielded `BytesMut`.Á Ô]
|
|||
|
|
ú <Ø]
|
|||
|
|
ן üà]"
|
|||
|
|
Þ¥ üƒ^2
|
|||
|
|
Š¦ ü¶^/
|
|||
|
|
×Á ¼æ^
|
|||
|
|
‚ˆ üþ^5
|
|||
|
|
2 # let io: &[u8] = b"\x00\x00\x0B\xFFHello world";Á ü´_4
|
|||
|
|
˜§ üé_0
|
|||
|
|
Ö§ üš`
|
|||
|
|
ªÅ üº`/
|
|||
|
|
, .length_adjustment(0) // default valueÁ üê`.
|
|||
|
|
+ .num_skip(4) // skip the first 4 bytesÁ ´™a
|
|||
|
|
ö¨ ü°a?
|
|||
|
|
–© üða&
|
|||
|
|
ß© <—b
|
|||
|
|
±È <Ÿb
|
|||
|
|
ן §b
|