2007 lines
718 KiB
Plaintext
2007 lines
718 KiB
Plaintext
|
rust
|
|||
|
|
y6 #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Á_Z㢮`]×Â6~ÚíñÜ7 -4180835ec126556aÁ tokioÁâYH+ÄS£ü4§…>ˆº$ -886576ce57e45364Á parking_lotÁ,kÞÖGϹ˾ϷxwOÜ -5fc2c3fdec45feedÁ lock_apiÁEcÓŽ/ÅS}sw‡A$P -0e8055cd433fa267Á
|
|||
|
|
scopeguardÁ’‰‘p ÒÞa¢ßöéqÓB -29f0bdb2ea82739eÁ parking_lot_coreÁªôqu�´<Üb3 Èn~É -385dbf21a0d1611bÁ smallvecÁØNôCt€ïAGV– -97fd81655f68edefÁ ®f©¾/ô)c§{õa“â‘ -a3906971a93fd1b8Á –WÉ?A©ú¡E2¯ëäu -8e0657b9e365f274Á mioÁU»"‘¦Ï¹Ç8³<u�½ -325017fc6dce34b0Á bytesÁz"ˆ9äš
|
|||
|
|
2s÷ "X"“ -f60c5f60586b21edÁ tokio_macrosÁ€§)£Í‰ÔœxðÁŠ–ü´ -a4c6e56303f3349dÁ socket2Áüß<%ñÁyðUe› -fe803a4340fa19d8Á signal_hook_registryÁ{lz…<Bžš;ë®
|
|||
|
|
å -cb4f4a08e32ec862Á errnoÁðšÿçNš&^
|
|||
|
|
�:Ón -ef17a36a98ab2a47Á futures_coreÁÍ© û4ù†ŽNx¼ -a28fb4b6ab5a68eeÁ K Ê ‚ $œ ¤,Ï ‚ ¥TÖ ‚ $& taskÁ$æ» rtÁtÍ testsÁ,ö‚ $ë´ä,“/‚ $ü.‡ memchr_innerÁdÙ ú $»»–„Áĺ춇ä,Ë‚ $À udpÁ Ê» netÁxFã ê Û»ê compatÁ4ý»Œ�G˜š read_arcÁDŠ» io-utilÁ˜U¬š read_exact_arcÁt°»¾&(š sync_bridgeÁ\É»¾FHš SyncIoBridgeÁdõ»¾gi contextÁ<»»ØpVŠ timeÁ$…»Ò€W× ð poll_proceedÁd±»ØpþŠ À â cfg_codecÁ
|
|||
|
|
cfg_compatÁ cfg_netÁ cfg_ioÁ cfg_rtÁ
|
|||
|
|
cfg_not_rtÁ cfg_timeÁ loomÁ ç ç cancellation_tokenÁ £ 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Á 6— 6 RetÁ 6 " move_children_to_parentÁ " remove_childÁ " increase_handle_refcountÁ " decrease_handle_refcountÁ = " cancelÁ CancellationTokenÁ Jð N× Pƒ R� U§ V™ Xã Z> \æ \ child_tokenÁ \Ü \Û \ cancelledÁ \ cancelled_ownedÁ \
|
|||
|
|
drop_guardÁ \ drop_guard_refÁ \ run_until_cancelledÁ e— e e \ run_until_cancelled_ownedÁ i— i i
|
|||
|
|
mŸ m× pŸ p° pŠ t×
|
|||
|
|
væ v
|
|||
|
|
new_futureÁ y° yŠ |Ÿ |— |æ €Ÿ €— €° €Š …— …° …Š ‰— ‰æ mpscÁ • ••••••••• •
|
|||
|
|
• ¡¥ ¡
|
|||
|
|
into_innerÁ •¤¥ ¤× •§¥ • make_acquire_futureÁ ©¥ © © ¬ • InnerFutureÁ ®Ÿ ®¥ •±¥ ± emptyÁ ³ •µ¥ µæ µŠ µ setÁ •º¥ ºæ º
|
|||
|
|
take_stateÁ º poll_reserveÁ º send_itemÁ º is_closedÁ º get_refÁ º closeÁ º
|
|||
|
|
abort_sendÁ •Ä¥ ă •Ç¥ Ç ErrorÁ Ç
|
|||
|
|
poll_readyÁ Ç
|
|||
|
|
poll_flushÁ Ç
|
|||
|
|
start_sendÁ Ç
|
|||
|
|
poll_closeÁ
|
|||
|
|
poll_semaphoreÁ Ñ ÑÑÑÑÑÑÑÑÑ Ñ
|
|||
|
|
Ñ Ñ Ñ
|
|||
|
|
Ñ
|
|||
|
|
PollSemaphoreÁ à semaphoreÁ à
|
|||
|
|
permit_futÁ Ñ ãæ ãÔ ã clone_innerÁ 㘠ã poll_acquireÁ ã poll_acquire_manyÁ ã available_permitsÁ ã add_permitsÁ Ñì› ì poll_nextÁ Ñïƒ Ññ× ÑóÉ reusable_boxÁ ö ööööööööö ö
|
|||
|
|
ö ö ö ReusableBoxFutureÁ „Ÿ „¥ „ boxedÁ ö ˆŸ ˆ¥ ˆæ ‹— ˆÝ �— ˆ try_setÁ �— � real_try_setÁ ‘Ÿ ‘— ‘ ˆ get_pinÁ ˆŠ ö—¥ —° —Š ö›¥ ö�¥ �× ö
|
|||
|
|
reuse_pin_boxÁ ¥ ¦ — ö
|
|||
|
|
CallOnDropÁ ¦ ¦— ¦± öª ª— ªæ ªÑ ö¯ ¯— ¯ã
|
|||
|
|
eitherÁ ´ ´´´´´´´´´ ´
|
|||
|
|
´ ´ ´
|
|||
|
|
´
|
|||
|
|
delegate_callÁ ´ Ä� Ä£ Ä Ä° ÄŠ ´Ê� Ê£ Ê poll_readÁ ´Î� Σ Î
|
|||
|
|
poll_fill_bufÁ Î consumeÁ ´Ó� Ó£ Ó
|
|||
|
|
start_seekÁ Ó
|
|||
|
|
poll_completeÁ ´Ø� Ø£ Ø
|
|||
|
|
poll_writeÁ Ø´ Ø
|
|||
|
|
poll_shutdownÁ Ø poll_write_vectoredÁ Ø is_write_vectoredÁ ´à� à£ à› àŸ# ´å� å£ å› å• å• å¢ åÆ å´ åØ utilÁ ðé ñ ññññññ
|
|||
|
|
MaybeDanglingÁ ø
|
|||
|
|
ø¥ øˆ ñ ü¥ üã ñÿ¥ ÿæ ñ‚— ‚° ‚Š … ðì ‡‘ ‡ì ð poll_bufÁ Š ŠŠŠŠŠŠŠŠŠ Š
|
|||
|
|
Š Š Š
|
|||
|
|
ŠŠ
|
|||
|
|
poll_read_bufÁ š¥ š“ Š poll_write_bufÁ �¥ �“ � MAX_BUFSÁ � ð ððð futureÁ ¦ with_cancellation_tokenÁ § §§§§§§§§§ §
|
|||
|
|
§ ³Ÿ ³— ³æ ¶ §¸Ÿ ¸— ¸° ¸Š §½— ½æ ¿ §Á— Á° ÁŠ ¦ ¦¦¦¦¦ FutureExtÁ Ê“/ Ê with_cancellation_token_ownedÁ ¦ Í¥ cfg_io_utilÁ tracingÁ Ð traceÁ codecÁ Ò bytes_codecÁ Ó ÓÓÓÓÓÓÓ Ûæ ÓÝ› Ý• Ý decodeÁ Óá• á encodeÁ Óä• ä÷2 Ò Ò decoderÁ è èèèèèè DecoderÁ ï› ï• ïÜ2 ï
|
|||
|
|
decode_eofÁ ï framedÁ ô¥ ÒÒ encoderÁ ÷ ÷÷ EncoderÁ ú› ú• ú÷2 ÒÒ framed_implÁ ÿ ÿÿÿÿÿÿÿÿÿ ÿ
|
|||
|
|
ÿ ÿ ÿ
|
|||
|
|
ÿÿÿÿÿ INITIAL_CAPACITYÁ ÿ
|
|||
|
|
WriteFrameÁ “ bufferÁ “ backpressure_boundaryÁ ÿ –> ÿ˜> ÿš÷ ÿœ÷ ÿž borrowÁ ÿ
|
|||
|
|
borrow_mutÁ ÿ¢Þ6 ÿ¤ñ6 ÿ¦¥ ¦¦ ¦£ ¦› ¦Ÿ# « « « « ÿ °¥ °š °¦ °¨ °• °¢ °Æ °´ ¸ °Ø ÒÒÒÒÒÒ…4 À ÀÀÀÀÀÀÀÀÀ À
|
|||
|
|
À À À
|
|||
|
|
ÀÀÀÀÀÀÀ Õ¥ Õ¦ Õæ Õ
|
|||
|
|
with_capacityÁ Õ
|
|||
|
|
from_partsÁ ÕÅ Õ get_mutÁ Õ get_pin_mutÁ Õ÷1 Õ codec_mutÁ Õ map_codecÁ à” à— Õ
|
|||
|
|
codec_pin_mutÁ Õ read_bufferÁ Õ read_buffer_mutÁ Õ write_bufferÁ Õ write_buffer_mutÁ ÕŠ6 Õ set_backpressure_boundaryÁ Õ˜ Õ
|
|||
|
|
into_partsÁ Àì¥ ì¦ ì› ìŸ# Àñ¥ ñš ñ¦ ñ• ñ¢ ñÆ ñ´ ñØ Àú¥ ú¦ ú× Àþ¥ þ¦ þæ �š ÒÒ Ò
|
|||
|
|
Ò framed_readÁ † ††††††††† †
|
|||
|
|
† † †
|
|||
|
|
†† –¥ –• –æ –Ò9 –Å –�: –�: –˜ –Ÿ3 – decoder_mutÁ – map_decoderÁ ¡” ¡— – decoder_pin_mutÁ –ò: –…; –ù; †¨¥ ¨• ¨› ¨Ÿ# †¥ š • • ¢ Æ ´ Ø †¶¥ ¶• ¶× Ò Ò framed_writeÁ » »»»»»»»»» »
|
|||
|
|
» » »
|
|||
|
|
»»» Ì¥ Ì– Ìæ ÌÒ9 ÌÅ Ì�: Ì�: ̘ Ì 4 Ì encoder_mutÁ Ì map_encoderÁ ×” ×— Ì encoder_pin_mutÁ Ìœ; Ì°; ÌŠ6 ÌÐ; Ìù; »à¥ àš à– à• à¢ àÆ à´ àØ »é¥ é• é› éŸ# »î¥ î¦ î× Ò Ò length_delimitedÁ ó óóóóóóóóó ó
|
|||
|
|
ó ó ó
|
|||
|
|
óóóóóóóóó LengthDelimitedCodecErrorÁ Š _privÁ ó Œæ Œ builderÁ Œ max_frame_lengthÁ Œ set_max_frame_lengthÁ Œ decode_headÁ Œ decode_dataÁ ó“› “• “Ü2 ó—• —÷2 ™ ó›> óÕE � LengthFieldTypeÁ � ����ó¤æ ¤
|
|||
|
|
big_endianÁ ¤
|
|||
|
|
little_endianÁ ¤
|
|||
|
|
native_endianÁ ¤äE ¤ length_field_typeÁ ª¥ ¤ length_field_lengthÁ ¤ length_field_offsetÁ ¤ length_adjustmentÁ ¤ num_skipÁ ¤ new_codecÁ ¤ new_readÁ ±¥ ¤ new_writeÁ ³¥ ¤
|
|||
|
|
new_framedÁ µ¥ ¤ num_head_bytesÁ ¤ get_num_skipÁ ¤ adjust_max_frame_lenÁ óº> ó¼× ó¾× óÒ
|
|||
|
|
ÒÒÒ lines_codecÁ Ä ÄÄÄÄÄÄÄÄÄ Ä
|
|||
|
|
Ä Ðæ Ð new_with_max_lengthÁ Ð
|
|||
|
|
max_lengthÁ Ä utf8Á Ô Ä without_carriage_returnÁ Ä×› ו ×Ü2 ×ó3 ÄÜ¥ Ü• Ü÷2 Äà> Äâ× Ää÷ ÄÒÒÒÒ any_delimiter_codecÁ ê êêêêêêêêê ê
|
|||
|
|
ê ê DEFAULT_SEEK_DELIMITERSÁ ê DEFAULT_SEQUENCE_WRITERÁ ê ùæ ù½K ùØK êý› ý• ýÜ2 € ýó3 ꃥ ƒ• ƒ÷2 ê‡> ê‰× ê‹÷ êÒÒÒÓ
|
|||
|
|
BytesCodecÁ ‘
|
|||
|
|
‘ˆ ÓÓÓ–ƒ Ó˜× ÓšÖ Ó Ó
|
|||
|
|
�� Ó Ÿ‹ Ó ¡ï
|
|||
|
|
Ó
|
|||
|
|
£§ ¤ù Ó¦> ÿ ReadFrameÁ ¨ eofÁ ¨ is_readableÁ ¨ü5 ¨ has_erroredÁ ÿ
|
|||
|
|
× ÿ RWFramesÁ ¯ readÁ ¯ writeÁ ÿ ²> À FramedPartsÁ ´¥ ´¦ ´ ioÁ ´÷1 ´ read_bufÁ ´ write_bufÁ ´»E À¼¥ ¼¦ ¼× ó BuilderÁ À
|
|||
|
|
max_frame_lenÁ À length_field_lenÁ ÀÆH ÀáH ÀúH À length_field_is_big_endianÁ ó Ç× ó
|
|||
|
|
ó ʃ ó ó LengthDelimitedCodecÁ ÍÕE ͺ ó
|
|||
|
|
Ð× óÒƒ ó DecodeStateÁ Ô HeadÁ Õ
|
|||
|
|
Ô DataÁ ×
|
|||
|
|
׈ óÚ× óó݃ óÄ
|
|||
|
|
LinesCodecÁ à
|
|||
|
|
next_indexÁ àØK à
|
|||
|
|
is_discardingÁ Ääƒ Äæ× Ä èÖ Ä
|
|||
|
|
Ä ë� Ä í‹ Ä
|
|||
|
|
ïï
|
|||
|
|
Äñ§ òù Ä LinesCodecErrorÁ ô MaxLineLengthExceededÁ õ
|
|||
|
|
ô IoÁ ÷
|
|||
|
|
÷ˆ Äú× ê AnyDelimiterCodecÁ üÀU üØK üÚU ü seek_delimitersÁ ü sequence_writerÁ ꂃ ê„× ê †Ö ê
|
|||
|
|
ê ‰� ê ‹‹ ê
|
|||
|
|
�ï
|
|||
|
|
ê�§ �ù ê AnyDelimiterCodecErrorÁ ’ MaxChunkLengthExceededÁ “
|
|||
|
|
’�W •
|
|||
|
|
•ˆ ê˜× •R š
|
|||
|
|
copy_to_bytesÁ › ›››››››› ¤¤ ¤æ ¤Å ¤�: ¤˜ ›ªŸ ª¤ ª• ª¢ ªÆ ª´ ªØ ›²¤ ²› ²Ÿ# š inspectÁ ¶ ¶¶¶¶¶¶¶¶¶ ¶
|
|||
|
|
¶ ¶ ¶ Ä£ Ä— Äæ Ę ¶É£ É— É„) ¶Í£ Í— ÍŸ* Í´ ͹* ÍÎ* Íé* ¶Õ¨ Õ— Õæ Õ˜ ¶Ú¨ Ú— ÚŸ* Ú´ Ú¹* ÚÎ* Úé* ¶â¨ â— â„) š§R æ æææææ§R ì£ ì“ ì ì ð š
|
|||
|
|
reader_streamÁ ò òòòòòòòòò ò DEFAULT_CAPACITYÁ ò þ£ þæ þÒ9 ò‚ £ ‚ › ‚ Ÿ# … š simplexÁ ‡ ‡ ‡ ‡ ‡ ‡ ‡ ‡ ‡ ‡ ‡
|
|||
|
|
‡ ‡ ‡
|
|||
|
|
‡ ‡ ‡ ‡ ‡ ‡ IoResultÁ › ¥ ‡ CLOSED_ERROR_MSGÁ ‡ ž Ò9 ž register_receiver_wakerÁ ž register_sender_wakerÁ ž take_receiver_wakerÁ ž take_sender_wakerÁ ž ´ ž close_receiverÁ ž close_senderÁ ‡ § ã ‡ © „) ‡ « ã ‡ Ÿ* ´ ¹* é* Î* ‡ æ š sink_writerÁ ´ ´ ´ ´ ´ ´ ´ ´ ´ ´ ´
|
|||
|
|
´ ´ Á ¤ Á æ Á Å Á �: Á ˜ ´ Ç ¤ Ç – Ç Ÿ Ç Ÿ* Ç ´ Ç ¹* ´ Î ¤ Î › Î Ÿ# ´ Ò ¤ Ò „) š
|
|||
|
|
stream_readerÁ Õ Õ Õ Õ Õ Õ Õ Õ Õ Õ Õ
|
|||
|
|
Õ Õ â ¤ â “ â – â æ â has_chunkÁ â into_inner_with_chunkÁ Õ é ¤ é “ é Å é �: é �: é ˜ Õ ð ¤ ð “ ð – ð „) Õ õ ¤ õ “ õ – õ ª) õ ¿) Õ û ¤ û “ Õ StreamReaderProjectÁ þ Ÿ þ ¤ þ “ þ ð þ chunkÁ Õ „
|
|||
|
|
¤ „
|
|||
|
|
“ „
|
|||
|
|
projectÁ Õ ˆ
|
|||
|
|
¤ ˆ
|
|||
|
|
“ ˆ
|
|||
|
|
– ˆ
|
|||
|
|
¥ ˆ
|
|||
|
|
• ˆ
|
|||
|
|
¢ ˆ
|
|||
|
|
Æ ˆ
|
|||
|
|
´ ˆ
|
|||
|
|
Ø š write_all_vectoredÁ ’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
|
|||
|
|
’
|
|||
|
|
âh ¡
|
|||
|
|
Ÿ ¡
|
|||
|
|
'bÁ ¡
|
|||
|
|
¨ ’
|
|||
|
|
¥
|
|||
|
|
¨ ¥
|
|||
|
|
° ¥
|
|||
|
|
Š ¨
|
|||
|
|
’
|
|||
|
|
advance_slicesÁ ª
|
|||
|
|
Ÿ š ššššššššš š
|
|||
|
|
š š š
|
|||
|
|
‡ ¢ º
|
|||
|
|
Š6 º
|
|||
|
|
´ º
|
|||
|
|
receiver_wakerÁ º
|
|||
|
|
sender_wakerÁ º
|
|||
|
|
bufÁ ‡ À
|
|||
|
|
× ‡ ReceiverÁ Â
|
|||
|
|
ð ‡ Ä
|
|||
|
|
× ‡ SenderÁ Æ
|
|||
|
|
ð ‡ È
|
|||
|
|
× Õ StreamReaderÁ Ê
|
|||
|
|
¤ Ê
|
|||
|
|
“ Ê
|
|||
|
|
ð Ê
|
|||
|
|
äg Õ Ï
|
|||
|
|
¤ Ï
|
|||
|
|
“ Ï
|
|||
|
|
× DropGuardÁ Ó
|
|||
|
|
ð Õ
|
|||
|
|
× DropGuardRefÁ ×
|
|||
|
|
Ÿ ×
|
|||
|
|
ð Ú
|
|||
|
|
Ÿ Ú
|
|||
|
|
× WaitForCancellationFutureÁ Ý
|
|||
|
|
Ÿ Ý
|
|||
|
|
» Ý
|
|||
|
|
…/ á
|
|||
|
|
â
|
|||
|
|
Ÿ á
|
|||
|
|
__assert_not_repr_packedÁ ä
|
|||
|
|
Ÿ á
|
|||
|
|
|
|||
|
|
ProjectionÁ æ
|
|||
|
|
'__pinÁ æ
|
|||
|
|
Ÿ æ
|
|||
|
|
» æ
|
|||
|
|
…/ á
|
|||
|
|
|
|||
|
|
ProjectionRefÁ ë
|
|||
|
|
½n ë
|
|||
|
|
Ÿ ë
|
|||
|
|
» ë
|
|||
|
|
…/ â
|
|||
|
|
†h ð
|
|||
|
|
½n â
|
|||
|
|
project_refÁ ò
|
|||
|
|
½n á
|
|||
|
|
__OriginÁ ô
|
|||
|
|
½n ô
|
|||
|
|
Ÿ ô
|
|||
|
|
__dummy_lifetimeÁ ô
|
|||
|
|
» ô
|
|||
|
|
…/ á
|
|||
|
|
ú
|
|||
|
|
½n ú
|
|||
|
|
Ÿ á
|
|||
|
|
MustNotImplDropÁ á
|
|||
|
|
þ
|
|||
|
|
¥ á
|
|||
|
|
€ Ÿ WaitForCancellationFutureOwnedÁ ‚ …/ ‚ » … … ƒn … «n ˆ ½n ˆ …/ ˆ » … ãn Œ ½n Œ …/ Œ » † †h � ½n † ¨o ’ ½n … Ão ” ½n ” ão ” …/ ” » … ™ ½n … p … œ ¥ … RunUntilCancelledFutureÁ Ÿ Ÿ Ÿ — Ÿ cancellationÁ Ÿ …/ ¤ ¥ Ÿ ¥ — ¤ ƒn ¨ Ÿ ¨ — ¤ «n « ½n « Ÿ « — « ör « …/ ¤ ãn ± ½n ± Ÿ ± — ± ör ± …/ ¥ †h · ½n ¥ ¨o ¹ ½n ¤ Ão » ½n » Ÿ » — » ão » ör » …/ ¤  ½n  Ÿ  — ¤ p ¤ Ç ¥ ¤ É Ÿ É — RunUntilCancelledFutureOwnedÁ Ì — Ì ör Ì …/ Ð Ñ — Ð ƒn Ó — Ð «n Õ ½n Õ — Õ ör Õ …/ Ð ãn Ú ½n Ú — Ú ör Ú …/ Ñ †h ß ½n Ñ ¨o á ½n Ð Ão ã ½n ã — ã ão ã ör ã …/ Ð é ½n é — Ð p Ð í ¥ Ð ï — •
|
|||
|
|
PollSendErrorÁ ñ
|
|||
|
|
ñ ¥ ñ ˆ •õ ¥ õ × • StateÁ ø ¥ ø IdleÁ ú
|
|||
|
|
ú ˆ ø AcquiringÁ ý
|
|||
|
|
ø ReadyToSendÁ ÿ
|
|||
|
|
ÿ ˆ ø ClosedÁ ‚
|
|||
|
|
• „ ¥ „ × •
|
|||
|
|
PollSenderÁ ‡ ¥ ‡ senderÁ ‡ º ‡ acquireÁ •
|
|||
|
|
Œ ¥ Œ × • PollSenderFutureÁ �
|
|||
|
|
� ¥ � ˆ • “ ¥ “ × ´ EitherÁ – � – £ – LeftÁ ™
|
|||
|
|
™ ˆ – RightÁ œ
|
|||
|
|
œ ˆ ´Ÿ � Ÿ £ Ÿ × ´£ � £ £ £ ƒ ðððð RestoreOnPendingÁ ª
|
|||
|
|
ð ¬
|
|||
|
|
made_progressÁ ðî § WithCancellationTokenFutureÁ ¯ Ÿ ¯ — ¯ û § ³ ´ Ÿ ´ — ³ ƒn · Ÿ · — ³ «n º ½n º Ÿ º — º û ³ ãn ¿ ½n ¿ Ÿ ¿ — ¿ û ´ †h Ä ½n ´ ¨o Æ ½n ³ Ão È ½n È Ÿ È — È ão È û ³ Î ½n Î Ÿ Î — ³ p ³ Ó ¥ ³ Õ Ÿ Õ — § WithCancellationTokenFutureOwnedÁ Ø — Ø û §Û Ü — Û ƒn Þ — Û «n à ½n à — à û Û ãn ä ½n ä — ä û Ü †h è ½n Ü ¨o ê ½n Û Ão ì ½n ì — ì ão ì û Û ñ ½n ñ — Û p Û õ ¥ Û ÷ — ’
|
|||
|
|
WriteAllVectoredÁ ù Ÿ ù Òi ù ¨ ù writerÁ ù bufsÁ ù _pinÁ ’
|
|||
|
|
€
|
|||
|
|
Ÿ €
|
|||
|
|
Òi €
|
|||
|
|
¨ €
|
|||
|
|
× ’
|
|||
|
|
…
|
|||
|
|
†
|
|||
|
|
Ÿ †
|
|||
|
|
Òi †
|
|||
|
|
¨ …
|
|||
|
|
ƒn Š
|
|||
|
|
Ÿ Š
|
|||
|
|
Òi Š
|
|||
|
|
¨ …
|
|||
|
|
«n Ž
|
|||
|
|
½n Ž
|
|||
|
|
Ÿ Ž
|
|||
|
|
Òi Ž
|
|||
|
|
¨ Ž
|
|||
|
|
Ô� Ž
|
|||
|
|
â� Ž
|
|||
|
|
î� …
|
|||
|
|
ãn –
|
|||
|
|
½n –
|
|||
|
|
Ÿ –
|
|||
|
|
Òi –
|
|||
|
|
¨ –
|
|||
|
|
Ô� –
|
|||
|
|
â� –
|
|||
|
|
î� †
|
|||
|
|
†h ž
|
|||
|
|
½n †
|
|||
|
|
¨o
|
|||
|
|
½n …
|
|||
|
|
Ão ¢
|
|||
|
|
½n ¢
|
|||
|
|
Ÿ ¢
|
|||
|
|
Òi ¢
|
|||
|
|
¨ ¢
|
|||
|
|
ão ¢
|
|||
|
|
Ô� ¢
|
|||
|
|
â� ¢
|
|||
|
|
î� …
|
|||
|
|
«
|
|||
|
|
½n «
|
|||
|
|
Ÿ «
|
|||
|
|
Òi «
|
|||
|
|
¨ …
|
|||
|
|
p …
|
|||
|
|
±
|
|||
|
|
¥ …
|
|||
|
|
³
|
|||
|
|
Ÿ ³
|
|||
|
|
Òi ³
|
|||
|
|
¨ ´
|
|||
|
|
SinkWriterÁ ·
|
|||
|
|
¤ ·
|
|||
|
|
ð ´ º
|
|||
|
|
¤ º
|
|||
|
|
× ´ ½
|
|||
|
|
¾
|
|||
|
|
¤ ½
|
|||
|
|
ƒn À
|
|||
|
|
¤ ½
|
|||
|
|
«n Â
|
|||
|
|
½n Â
|
|||
|
|
¤ Â
|
|||
|
|
ð ½
|
|||
|
|
ãn Æ
|
|||
|
|
½n Æ
|
|||
|
|
¤ Æ
|
|||
|
|
ð ¾
|
|||
|
|
†h Ê
|
|||
|
|
½n ¾
|
|||
|
|
¨o Ì
|
|||
|
|
½n ½
|
|||
|
|
Ão Î
|
|||
|
|
½n Î
|
|||
|
|
¤ Î
|
|||
|
|
ão Î
|
|||
|
|
ð ½
|
|||
|
|
Ó
|
|||
|
|
½n Ó
|
|||
|
|
¤ ½
|
|||
|
|
p ½
|
|||
|
|
×
|
|||
|
|
¥ ½
|
|||
|
|
Ù
|
|||
|
|
¤ ò ReaderStreamÁ Û
|
|||
|
|
£ Û
|
|||
|
|
readerÁ Û
|
|||
|
|
¬k Û
|
|||
|
|
capacityÁ òà
|
|||
|
|
£ à
|
|||
|
|
× ò ã
|
|||
|
|
ä
|
|||
|
|
£ ã
|
|||
|
|
ƒn æ
|
|||
|
|
£ ã
|
|||
|
|
«n è
|
|||
|
|
½n è
|
|||
|
|
£ è
|
|||
|
|
ᇠè
|
|||
|
|
¬k è
|
|||
|
|
÷‡ ã
|
|||
|
|
ãn î
|
|||
|
|
½n î
|
|||
|
|
£ î
|
|||
|
|
ᇠî
|
|||
|
|
¬k î
|
|||
|
|
÷‡ ä
|
|||
|
|
†h ô
|
|||
|
|
½n ä
|
|||
|
|
¨o ö
|
|||
|
|
½n ã
|
|||
|
|
Ão ø
|
|||
|
|
½n ø
|
|||
|
|
£ ø
|
|||
|
|
ão ø
|
|||
|
|
ᇠø
|
|||
|
|
¬k ø
|
|||
|
|
÷‡ ã
|
|||
|
|
ÿ
|
|||
|
|
½n ÿ
|
|||
|
|
£ ã
|
|||
|
|
p ã
|
|||
|
|
ƒ¥ ã
|
|||
|
|
…£ ¶
|
|||
|
|
InspectWriterÁ ‡¨ ‡— ‡Ô� ‡± ¶ Œ �¨ �— Œƒn �¨ �— Œ«n “½n “¨ “— “Ô� “± Œãn ™½n ™¨ ™— ™Ô� ™± �†h Ÿ½n �¨o ¡½n ŒÃo £½n £¨ £— £ão £Ô� £± Œª½n ª¨ ª— Œ p Œ¯¥ Œ±¨ ±— ¶
|
|||
|
|
InspectReaderÁ ´£ ´— ´á‡ ´± ¶¹ º£ º— ¹ƒn ½£ ½— ¹«n À½n À£ À— ÀᇠÀ± ¹ãn ƽn Æ£ Æ— ÆᇠƱ º†h ̽n º¨o νn ¹Ão нn У З Ðão Ðᇠб ¹×½n ×£ ×— ¹ p ¹Ü¥ ¹Þ£ Þ— › CopyToBytesÁ ᤠáð ›ä¤ ä× › ç è¤ çƒn ê¤ ç«n ì½n ì¤ ìð çãn ð½n ð¤ ðð è†h ô½n è¨o ö½n çÃo ø½n ø¤ øão øð çý½n ý¤ ç p ç�¥ 烤 » FramedWriteÁ …¥ …– …ð » ‰ Š¥ Š– ‰ƒn �¥ �– ‰«n �½n �¥ �– �ð ‰ãn •½n •¥ •– •ð Š†h š½n Š¨o œ½n ‰Ão ž½n ž¥ ž– žão žð ‰¤½n ¤¥ ¤– ‰ p ‰©¥ ‰«¥ «– †
|
|||
|
|
FramedReadÁ ®¥ ®• ®ð † ² ³¥ ³• ²ƒn ¶¥ ¶• ²«n ¹½n ¹¥ ¹• ¹ð ²ãn ¾½n ¾¥ ¾• ¾ð ³†h ýn ³¨o Žn ²Ão ǽn Ç¥ Ç• Ção Çð ²Í½n Í¥ Í• ² p ²Ò¥ ²Ô¥ Ô• À FramedÁ ×¥ צ ×ð À Û Ü¥ ܦ Ûƒn ߥ ߦ Û«n â½n ⥠⦠âð Ûãn ç½n ç¥ ç¦ çð ܆h ì½n ܨo î½n ÛÃo ð½n ð¥ ð¦ ðão ðð Ûö½n ö¥ ö¦ Û p Ûû¥ Ûý¥ ý¦ ÿ
|
|||
|
|
FramedImplÁ €¥ €¦ €¸x €ð €º €÷1 ÿ ‡¥ ‡¦ ‡¸x ‡× ÿ Œ �¥ �¦ �¸x Œƒn ‘¥ ‘¦ ‘¸x Œ«n •½n •¥ •¦ •¸x •ð •º •÷1 Œãn �½n �¥ �¦ �¸x �ð �º �÷1 �†h ¥½n �¨o §½n ŒÃo ©½n ©¥ ©¦ ©¸x ©ão ©ð ©º ©÷1 Œ²½n ²¥ ²¦ ²¸x Œ p Œ¸¥ Œº¥ º¦ º¸x
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
!
|
|||
|
|
,
|
|||
|
|
3
|
|||
|
|
4
|
|||
|
|
5
|
|||
|
|
6
|
|||
|
|
6
|
|||
|
|
6
|
|||
|
|
:
|
|||
|
|
:
|
|||
|
|
;
|
|||
|
|
;
|
|||
|
|
<
|
|||
|
|
=
|
|||
|
|
?
|
|||
|
|
O
|
|||
|
|
O
|
|||
|
|
O
|
|||
|
|
Q
|
|||
|
|
S
|
|||
|
|
S
|
|||
|
|
V
|
|||
|
|
V
|
|||
|
|
Y
|
|||
|
|
^
|
|||
|
|
_
|
|||
|
|
`
|
|||
|
|
a
|
|||
|
|
d
|
|||
|
|
e
|
|||
|
|
o
|
|||
|
|
o
|
|||
|
|
o
|
|||
|
|
s
|
|||
|
|
s
|
|||
|
|
s
|
|||
|
|
u
|
|||
|
|
u
|
|||
|
|
u
|
|||
|
|
x
|
|||
|
|
{
|
|||
|
|
{
|
|||
|
|
{
|
|||
|
|
„
|
|||
|
|
„
|
|||
|
|
„
|
|||
|
|
ˆ
|
|||
|
|
ˆ
|
|||
|
|
ˆ
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
¸
|
|||
|
|
¸
|
|||
|
|
¸
|
|||
|
|
¹
|
|||
|
|
½
|
|||
|
|
¾
|
|||
|
|
¾
|
|||
|
|
¾
|
|||
|
|
¿
|
|||
|
|
À
|
|||
|
|
Á
|
|||
|
|
Â
|
|||
|
|
Ã
|
|||
|
|
Æ
|
|||
|
|
Ê
|
|||
|
|
Ê
|
|||
|
|
Ê
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ì
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
å
|
|||
|
|
æ
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
é
|
|||
|
|
é
|
|||
|
|
é
|
|||
|
|
ê
|
|||
|
|
ë
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
ð
|
|||
|
|
ò
|
|||
|
|
ò
|
|||
|
|
ò
|
|||
|
|
ô
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
•
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
—
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
›
|
|||
|
|
�
|
|||
|
|
Ÿ
|
|||
|
|
Ÿ
|
|||
|
|
Ÿ
|
|||
|
|
²
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
É
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ò
|
|||
|
|
Ö
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Þ
|
|||
|
|
Þ
|
|||
|
|
Þ
|
|||
|
|
Þ
|
|||
|
|
Þ
|
|||
|
|
ß
|
|||
|
|
ä
|
|||
|
|
ä
|
|||
|
|
ä
|
|||
|
|
ë
|
|||
|
|
ë
|
|||
|
|
ë
|
|||
|
|
ì
|
|||
|
|
í
|
|||
|
|
í
|
|||
|
|
í
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
þ
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
ˆ
|
|||
|
|
‰
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
¼
|
|||
|
|
¼
|
|||
|
|
¼
|
|||
|
|
Ä
|
|||
|
|
Ä
|
|||
|
|
Ä
|
|||
|
|
Ë
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
ò
|
|||
|
|
ò
|
|||
|
|
ó
|
|||
|
|
ó
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
Ÿ
|
|||
|
|
¡
|
|||
|
|
£
|
|||
|
|
¥
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
·
|
|||
|
|
¸
|
|||
|
|
¸
|
|||
|
|
¸
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
º
|
|||
|
|
Û
|
|||
|
|
Ü
|
|||
|
|
Ý
|
|||
|
|
Þ
|
|||
|
|
ß
|
|||
|
|
ã
|
|||
|
|
ä
|
|||
|
|
å
|
|||
|
|
æ
|
|||
|
|
ç
|
|||
|
|
è
|
|||
|
|
é
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
ö
|
|||
|
|
÷
|
|||
|
|
ø
|
|||
|
|
ø
|
|||
|
|
ø
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
›
|
|||
|
|
œ
|
|||
|
|
�
|
|||
|
|
Ÿ
|
|||
|
|
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¦
|
|||
|
|
¬
|
|||
|
|
¬
|
|||
|
|
¬
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
³
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
¹
|
|||
|
|
¹
|
|||
|
|
¹
|
|||
|
|
Ñ
|
|||
|
|
Ò
|
|||
|
|
Ó
|
|||
|
|
Õ
|
|||
|
|
Ö
|
|||
|
|
Ú
|
|||
|
|
Û
|
|||
|
|
Ü
|
|||
|
|
Ý
|
|||
|
|
Þ
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
æ
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
í
|
|||
|
|
í
|
|||
|
|
í
|
|||
|
|
ñ
|
|||
|
|
ñ
|
|||
|
|
ñ
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
‘
|
|||
|
|
’
|
|||
|
|
’
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
¦
|
|||
|
|
§
|
|||
|
|
¨
|
|||
|
|
©
|
|||
|
|
ª
|
|||
|
|
¬
|
|||
|
|
|
|||
|
|
®
|
|||
|
|
¯
|
|||
|
|
°
|
|||
|
|
±
|
|||
|
|
³
|
|||
|
|
µ
|
|||
|
|
·
|
|||
|
|
¸
|
|||
|
|
¹
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
½
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
Ó
|
|||
|
|
Ô
|
|||
|
|
Ö
|
|||
|
|
Ú
|
|||
|
|
Ú
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
ü
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
‚
|
|||
|
|
‚
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
—
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
›
|
|||
|
|
ž
|
|||
|
|
ž
|
|||
|
|
|
|||
|
|
|
|||
|
|
¢
|
|||
|
|
¢
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
Ë
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ó
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Þ
|
|||
|
|
å
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
ç
|
|||
|
|
é
|
|||
|
|
ì
|
|||
|
|
ì
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
ò
|
|||
|
|
ò
|
|||
|
|
û
|
|||
|
|
û
|
|||
|
|
û
|
|||
|
|
ƒ
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
‡
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Œ
|
|||
|
|
Œ
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
§
|
|||
|
|
¨
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
¯
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
Ç
|
|||
|
|
É
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ð
|
|||
|
|
Ð
|
|||
|
|
Ð
|
|||
|
|
Ð
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ô
|
|||
|
|
Ø
|
|||
|
|
Ú
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Þ
|
|||
|
|
Þ
|
|||
|
|
Þ
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
á
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
ì
|
|||
|
|
ì
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
…
|
|||
|
|
|
|||
|
|
|
|||
|
|
¡
|
|||
|
|
¡
|
|||
|
|
¢
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¦
|
|||
|
|
¨
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
¬
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
±
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
Ä
|
|||
|
|
Å
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
ç
|
|||
|
|
ì
|
|||
|
|
í
|
|||
|
|
î
|
|||
|
|
ô
|
|||
|
|
ô
|
|||
|
|
ô
|
|||
|
|
ô
|
|||
|
|
ô
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ú
|
|||
|
|
‡
|
|||
|
|
|
|||
|
|
Ž
|
|||
|
|
|
|||
|
|
Ž
|
|||
|
|
|
|||
|
|
Ž
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
|
|||
|
|
‘
|
|||
|
|
|
|||
|
|
‘
|
|||
|
|
|
|||
|
|
‘
|
|||
|
|
|
|||
|
|
¥
|
|||
|
|
|
|||
|
|
¥
|
|||
|
|
|
|||
|
|
¨
|
|||
|
|
|
|||
|
|
¨
|
|||
|
|
|
|||
|
|
¨
|
|||
|
|
|
|||
|
|
ª
|
|||
|
|
|
|||
|
|
ª
|
|||
|
|
|
|||
|
|
Á
|
|||
|
|
|
|||
|
|
Á
|
|||
|
|
|
|||
|
|
Á
|
|||
|
|
|
|||
|
|
Å
|
|||
|
|
|
|||
|
|
Å
|
|||
|
|
|
|||
|
|
Å
|
|||
|
|
|
|||
|
|
É
|
|||
|
|
|
|||
|
|
É
|
|||
|
|
|
|||
|
|
É
|
|||
|
|
|
|||
|
|
Ò
|
|||
|
|
|
|||
|
|
Ò
|
|||
|
|
|
|||
|
|
Ò
|
|||
|
|
|
|||
|
|
Ö
|
|||
|
|
|
|||
|
|
Ö
|
|||
|
|
|
|||
|
|
Ö
|
|||
|
|
|
|||
|
|
Ü
|
|||
|
|
|
|||
|
|
Ü
|
|||
|
|
|
|||
|
|
Ü
|
|||
|
|
|
|||
|
|
ä
|
|||
|
|
|
|||
|
|
‡
|
|||
|
|
¨
|
|||
|
|
Ó
|
|||
|
|
÷
|
|||
|
|
÷
|
|||
|
|
÷
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
•
|
|||
|
|
•
|
|||
|
|
•
|
|||
|
|
¢
|
|||
|
|
¢
|
|||
|
|
¢
|
|||
|
|
¦
|
|||
|
|
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
·
|
|||
|
|
Þ
|
|||
|
|
„
|
|||
|
|
|
|||
|
|
„
|
|||
|
|
|
|||
|
|
„
|
|||
|
|
|
|||
|
|
Š
|
|||
|
|
|
|||
|
|
¼
|
|||
|
|
|
|||
|
|
¼
|
|||
|
|
|
|||
|
|
¼
|
|||
|
|
|
|||
|
|
À
|
|||
|
|
|
|||
|
|
â
|
|||
|
|
|
|||
|
|
â
|
|||
|
|
|
|||
|
|
â
|
|||
|
|
|
|||
|
|
æ
|
|||
|
|
|
|||
|
|
�
|
|||
|
|
½
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
ê
|
|||
|
|
�
|
|||
|
|
¶
|
|||
|
|
ß
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
‘
|
|||
|
|
ï8 ï8g8 ïú·úѨž€Û®‚Ö
|
|||
|
|
°
|
|||
|
|
ý
|
|||
|
|
› Æ ì Ò ô ÊŠ ‘ ‘ ’ÉO “ˆ Ó ¹ÞÍÁ•î0 Û‘· Ø‘· ¿c‘· ™‘· Ðì‘· µß‘·‘· º‘· íß‘·‘· še‘· ³ ‘· ï‘· ú‘· à à BytesÁ ĵ £ Å‘ £ Æ dataÁ £ Ç vtableÁ £ î ”«ó0…` ú‘·   BytesMutÁ õ œ Ä‘ œ Å capÁ œ Æ‚¸ œ Gî—y™ï¼ ¿c € € ô™ „ð …º †÷1 ýDns¶qZ– ¥¦¸x “í € € ô™ „ð …º †÷1 ýDns¶qZ–¥¦¸x ·çº ·£º ¿c ¨ ¨ æP ©÷P ª‚Q «ü5 ¬�Q ZÔn°—Nêb ³ ¯ ¯ ½Q °ÍQ ±ÙQ §R8µ¥¥� ³ ô» ³ “ “ ê5 ”ü5 •Š6 +¸zŠÅ<‰ é ô»¾¹ é “½¾¹ ɼô» £É¼ô» ɼ“½ £É¼“½ $E € € ô™ „ð …º †÷1 ýDns¶qZ–çºíº£
|
|||
|
|
€ € ô™ „ð …º †÷1 ýDns¶qZ–çºË»¨š “í × × ³— Úð À ßð$.ï}¤Å»Ë» úçº ú × × ³— Úð À ßð$.ï}¤çºíº $E¬À
|
|||
|
|
× × ³— Úð À ßð$.ï}¤çºË»Õ¿ ¿c¬À ¿c ´ ´ òQ ·•R ¸÷1 ¹§R º·R »»E Ö"#òEVµçºíº “í ® ® î” ±ð † ŒˆÓÅ´˜áéÅ»• Ñçº Ñ ® ® î” ±ð † ŒˆÓÅ´˜áé纕 $EìÂ
|
|||
|
|
® ® î” ±ð † ŒˆÓÅ´˜áéçºÔÂÕ¿ ¿cì “í … … ¨’ ˆð » ¤…ÉŠª|9ÙÅ»– ¨çº ¨ … … ¨’ ˆð » ¤…ÉŠª|9Ù纖
|
|||
|
|
… … ¨’ ˆð » ¤…ÉŠª|9Ù纶ÄÕ¿ $E … … ¨’ ˆð » ¤…ÉŠª|9Ù纟à ¿c … … ¨’ ˆð » ¤…ÉŠª|9Ùçºíº ¿c À À íR ÁüR ó ‘S ó ÃÆH ó ÄáH ó ÅúH ó ÆÁS ó f\
|
|||
|
|
ãv?, ÛÊÆ ØÊÆ Š ÊÆ ¿c Í Í ‡T ÎÕE ó Ϻ ó ú,Q�Ÿ—Æ… ØÜÇ ¿c Ô Õ ÖàT × ØñT Ùˆ ó [9ìMºÎÆ™ Û¨È Ø¨È Š ¨È ïÜÇ úÜÇÒ¸ ³ ÜÇ ž ž ž ž ž ³ ÊÆ ¿c Š Š šE ‹»E ó ¼Ú„f˜IÉ ÄcôÉ ¾ ôÉ Ø à à ®U áÀU Ä âØK Ä ãÚU Ä åØ`.�ó ¿c¿Ê ™¿Ê Ðì¿Ê µß¿Ê¿Ê º¿Ê íß¿Ê¿Ê še¿Ê ï¿Ê ú¿Êçº ³ ¿Ê ¿c ô õ öîV ÷ ø�W ùˆ jV>›0,| Äc‰Ì é ‰Ìßß • à… ¬
|
|||
|
|
ÑøÿËO Ÿ ¾ ‰Ì Ø ü ü ´W ýÀU ê þØK ê ÿÚU ê €åW ê �üW ê ÛE�¥(ƒ�ð ¿cžÍ ™žÍ ÐìžÍ µßžÍžÍ ºžÍ íßžÍžÍ šežÍ ïžÍ úžÍçº ³ žÍ ¿c ’ “ ”™Y • –�W —ˆ ÁŠz@ cc Äc€Ï é €ÏÞÌ ¾ €Ï ¿c á á �� ãð › ÿO"ÍÄPË
|
|||
|
|
¤ “í á á �� ãð › ÿO"ÍÄPË
|
|||
|
|
¤ €çº €ëÏ
|
|||
|
|
¨Ð Ÿ
|
|||
|
|
$EëÏ “í ´ ´ ¡� ·á‡ ¶ ¸± ¶ :ËÕ<ë�¡£— Ûçº Û ´ ´ ¡� ·á‡ ¶ ¸± ¶ :ËÕ<ë�¡ £— ’ôÑ ÅôÑ “í ‡ ‡ µŠ ŠÔ� ¶ ‹± ¶ D™EV?c¨ÜÑ ®çº ® ‡ ‡ µŠ ŠÔ� ¶ ‹± ¶ D™EV?c ¨¶Ò Å²Ó ’²Ó ¿c Û
|
|||
|
|
Û
|
|||
|
|
Ň Ý
|
|||
|
|
ᇠò Þ
|
|||
|
|
¬k ò ß
|
|||
|
|
÷‡ ò ³¡�š£HÔ˜°Ò “í Û
|
|||
|
|
Û
|
|||
|
|
Ň Ý
|
|||
|
|
ᇠò Þ
|
|||
|
|
¬k ò ß
|
|||
|
|
÷‡ ò ³¡�š£HÔ˜ÖÑ ‚çº ‚•Ô $E•Ô ¿c º
|
|||
|
|
º
|
|||
|
|
¢ »
|
|||
|
|
Š6 ‡ ¼
|
|||
|
|
´ ‡ ½
|
|||
|
|
‚k ‡ ¾
|
|||
|
|
˜k ‡ ¿
|
|||
|
|
¬k ‡ E+ªjb ¿c Â
|
|||
|
|
Â
|
|||
|
|
Äk Ã
|
|||
|
|
ð ‡ ‹·×µ¶©† Œ"ÃÖ ’ÃÖ ¿c Æ
|
|||
|
|
Æ
|
|||
|
|
ék Ç
|
|||
|
|
ð ‡ 4V¹ÛYÙª Œ"Ž× ÅŽ× ¿c ·
|
|||
|
|
·
|
|||
|
|
«… ¹
|
|||
|
|
ð ´ !Û‰¢ô (šÐ “í ·
|
|||
|
|
·
|
|||
|
|
«… ¹
|
|||
|
|
ð ´ !Û‰¢ô (×Ð Ö
|
|||
|
|
çº Ö
|
|||
|
|
Ù× ÅÙ× $EÙ× ’Ù× ¿c Ê
|
|||
|
|
Ê
|
|||
|
|
Œl Í
|
|||
|
|
ð Õ Î
|
|||
|
|
äg Õ ôèÚö™þ šÐ“ ’„Ù v„Ù “í„Ù
|
|||
|
|
„Ù¥ ¿c ù ù ¤� ý Ô� ’
|
|||
|
|
þ â� ’
|
|||
|
|
ÿ î� ’
|
|||
|
|
—ýõõ(ÏG Ÿ Òi¨ “í ù ù ¤� ý Ô� ’
|
|||
|
|
þ â� ’
|
|||
|
|
ÿ î� ’
|
|||
|
|
—ýõõ(ÏG Ÿ ÒiÏ¿ °
|
|||
|
|
çº °
|
|||
|
|
€Ú ‚Ø ù ù ¤� ý Ô� ’
|
|||
|
|
þ â� ’
|
|||
|
|
ÿ î� ’
|
|||
|
|
—ýõõ(ÏG 8 8ÖÚ ¿c Ó
|
|||
|
|
Ó
|
|||
|
|
Ül Ô
|
|||
|
|
ð „ù®f{ð< Œ"»Ü ¿c ×
|
|||
|
|
×
|
|||
|
|
€m Ù
|
|||
|
|
ð °wØýòká Ÿ Œ" ×
|
|||
|
|
×
|
|||
|
|
€m Ù
|
|||
|
|
ð °wØýòká 8 «½ J J ‘ Kð |¯-Yñ‚
|
|||
|
|
x ¬½îÝ “í Ý
|
|||
|
|
Ý
|
|||
|
|
·m ß
|
|||
|
|
» à
|
|||
|
|
…/ רƄkUó Ÿ ý
|
|||
|
|
çº ý
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
·m ß
|
|||
|
|
» à
|
|||
|
|
…/ רƄkUó Ÿ “í ‚ ‚ Ðp ƒ …/ „ » ¨wÞI´£ › çº › Âß ¿cîÝ ØîÝ µßîÝîÝ ™îÝ šeîÝ Œ"îÝ ³ îÝ ¿cüÞ ‚ØüÞ ¿cÂß ‚ØÂß “í Ÿ Ÿ Çr ¢ ör £ …/ ¢³qÞƒÿd ŸÜÑ Æ çº Æ Ÿ Ÿ Çr ¢ ör £ …/ ¢³qÞƒÿd Ÿ¶Ò ‚Øìá “í Ì Ì Ãu Î ör Ï …/ |ùÿOijÊõ¶Ò ì çº ì Ì Ì Ãu Î ör Ï …/ |ùÿOijÊõ — ‚Ø�ã ¿c ñ ñ ò ùw ô ˆ • y×é¾ÀÉSnçº Äcáã ¾ áã ¿c ø ú û Íx ü ˆ • ý þ æx ÿ € üx � ˆ • ‚ ƒ œy QŠts :ÄOçº ¿c ‡ ‡ Äy ‰ Þy • Š º • ‹ ôy • £œÔ\YLLçº ¿c � � � ˜z ’ ˆ • ý×�+˜^¢ßçº Øå
|
|||
|
|
åçº $E à à Ñ! áæ! Ñ â÷! Ñ çµ÷>² K ØÓæ ¿cÓæ à ÓæÔ^Ô^ SemaphoreÁ Õ^ ll_semÁùU .#hý±ës ‚Ø „ „ ¯$ ‡Ø$ ö GgïkÆ) 8Å» � óç ¿cóç Œ" ¦ ¦ ê& ©± ö (ƒìÍesX ¶Ò ¿c – ™ š øz › ˆ œ � ‘{ ž ˆ
|
|||
|
|
cçþ(<¨Y �ÖÑ Ø†é ‚Ø†é ’†é v†é «†é ņé $E†é
|
|||
|
|
†é› Œ" ø ø ù©, ûˆ ñ l�j«?¡Pçº ‚Ø ø ø ù©, ûˆ ñ l�j«?¡PÈã “í ¯ ¯ ³| ² û § ´õk <cÃ< ŸÜÑ Ò çº Ò ¯ ¯ ³| ² û § ´õk <cÃ< Ÿ¶Ò ‚Ø�ì “í Ø Ø ‰ Ú û § :ºG¾ê¬¶Ò ô çº ô Ø Ø ‰ Ú û § :ºG¾ê¬Èã ‚Ø‘í Êçº ” ‘Ì Àß Ô• ‘É ÀÜ Ô– ‘Ê ÀÒ ÍÝ Ôä à‚ üP JÄ ‡ ï ࣠– ˜ ‘‡ € ¨ú ×¼ ´¶ ®î …Ç ÀÐ ÍÚ Ô¼ Šæ àú ô„ ü˜ ’ä áà
|
|||
|
|
Û
|
|||
|
|
À
|
|||
|
|
º
|
|||
|
|
Ä
|
|||
|
|
Â
|
|||
|
|
È
|
|||
|
|
Æ
|
|||
|
|
º
|
|||
|
|
·
|
|||
|
|
Ï
|
|||
|
|
Ê
|
|||
|
|
€
|
|||
|
|
ù Õ
|
|||
|
|
Ó
|
|||
|
|
Ú
|
|||
|
|
×
|
|||
|
|
N Jm Ý
|
|||
|
|
t ‚ õ ñ „ ø Œ ‡ “ � ñ à� „Ÿ – š ‘è à† üT Jœ ‘ê àˆ ü� ‘ë à‰ üR JŸ ‘í à‹ ü¡ ‘ï à� ü£ ‘ñ à� üU J¦ ‘² ¯– ¨˜ “› ͺ Àà à‡ üZ JÝ ‘“ Í× àý üá ‘ä ‘— ÍÜ àƒ ü² €ö ×Í ®¤ …ý á× ´ª ‡ÿ
|
|||
|
|
Û
|
|||
|
|
Ó
|
|||
|
|
·
|
|||
|
|
û Ê
|
|||
|
|
«
|
|||
|
|
ù ú
|
|||
|
|
Ý
|
|||
|
|
™ ‚  Ÿ é Ì Î ¯ ñ Ø ¸ º €š ¨œ “ä ô‹ ’ž ¯¢ ¯ ¯¤ ¯¦ €ì ר ®é …² á‚ Û
|
|||
|
|
Î ·
|
|||
|
|
ì àà – ° €ñ × ®à …ª áˆ
|
|||
|
|
Ê
|
|||
|
|
Ç ‡ å – û ý ×Ò Ô ®© « …Ÿ ¡¢£ ¾ Šâ ô‰ ’¤ ñ À Šæ ô� ’§ ñ � ƒ áÜ Þ ´É ´â ‡© Â
|
|||
|
|
Ò ·
|
|||
|
|
ð Ê
|
|||
|
|
Ê – Í ´Ú ‡ Æ
|
|||
|
|
Ç ·
|
|||
|
|
Ø – ¯ ± ‡ƒ … Û
|
|||
|
|
§ Â
|
|||
|
|
« Æ
|
|||
|
|
Ó
|
|||
|
|
×
|
|||
|
|
X J¯ ¦ü ø×
|
|||
|
|
Ù
|
|||
|
|
·
|
|||
|
|
õ Ê
|
|||
|
|
Î – ±
|
|||
|
|
³
|
|||
|
|
ù ¥
|
|||
|
|
ù p Ý
|
|||
|
|
y ‚ € Ÿ … Ì — „Ä – ‚ ø¸ ¯ Á Ø L JM Jþ
|
|||
|
|
€ Ý
|
|||
|
|
œ ž ‚ Ç É Ÿ í ï Ì ó à› „Ó – Ó Õ ¯ õ ÷ Ø Í Š í
|
|||
|
|
ÛØ
|
|||
|
|
¿c#D™ñÐìµßºíßše³ ï= ú “í# ·wé
|
|||
|
|
£$E
|
|||
|
|
? ú8 Ñ
|
|||
|
|
¨
|
|||
|
|
ž
|
|||
|
|
Äc¾ € Û
|
|||
|
|
’
|
|||
|
|
Å* ®# ‚
|
|||
|
|
Œ"
|
|||
|
|
Ö
|
|||
|
|
-v
|
|||
|
|
°
|
|||
|
|
‚Ø
|
|||
|
|
|
|||
|
|
«½D¬½ ý
|
|||
|
|
›
|
|||
|
|
Æ
|
|||
|
|
ì
|
|||
|
|
à
|
|||
|
|
� « Ò ô
|
|||
|
|
Ê
|
|||
|
|
_ÁD± ± $µ 5 8 6 j ü‘) ’ ,© £ / _Á _Á _Á _ÁLº 5 B ƒÑ  ü“1 ÷ ûü ,² Íü � Íü • 6 b",;\n\r"Á $ì 5 B ûü ï üÅ, ø ûü ,ä …þ Š …þ ’ 6 b","Á _Á _Á _ÁüŒ O
|
|||
|
|
ð°ÒÂÙ “Ø“Ø ”ØÎ •Øˆä o
|
|||
|
|
³Î¢½ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÞÌ °Ò ÂÙ À Í
|
|||
|
|
¿
|
|||
|
|
ä€ À»
|
|||
|
|
ê€ üš 8
|
|||
|
|
ñ°ÒÂÙ Ì�Ì� k Î�ü¸� Ï� local_wakerÁ¸� Ð� extÁ¸� Ñ� _markerÁ¸� Ò� _marker2Á¸� f'EwÚ]¾å œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã�€ †ü’ A
|
|||
|
|
<’
|
|||
|
|
|
|||
|
|
Ç€�€ ñ°ÒÂÙØ�†E
|
|||
|
|
@ (ÂÔ
|
|||
|
|
|
|||
|
|
ˆØʀʀ PollFnÁ Ì€±À€ ¡Ab«SÁhæƒ š
|
|||
|
|
] øÃ’ G
|
|||
|
|
§„ | ƒ
|
|||
|
|
§„ ›
|
|||
|
|
öX §„
|
|||
|
|
µ
|
|||
|
|
¾ Â ÏÔ
|
|||
|
|
„ا„ ç ‹
|
|||
|
|
õ ù œØ�€ 4 @ æ
|
|||
|
|
È �€ Û
|
|||
|
|
œØ �€
|
|||
|
|
& é õ ü ¨ ¶ & ; A
|
|||
|
|
ð \ øÄŒ O
|
|||
|
|
|
|||
|
|
‡ • ÂØ
|
|||
|
|
|
|||
|
|
@ Ú
|
|||
|
|
ÄÚ
|
|||
|
|
|
|||
|
|
è ñ ú 7
|
|||
|
|
# * 1 : D
|
|||
|
|
|
|||
|
|
®Ãÿ W û
|
|||
|
|
! ~ Ãÿ ‰ Ì�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ä€ $
|
|||
|
|
ê€ »
|
|||
|
|
§„ ½ §„ æƒ $ ä€ - ê€ 6 §„ ‰ R ú ó‚ „¾„¾ PinÁ †¾‰ ˜X $ ]È=„kt•½… @ ½… I ½… R ÀŠ ú ÀŠ ÀŠ m u �€ $ ÀŠ Ž – X ` h p x € �€ / 7 þB ÍQE ä€ ¬kM ê€ ÍQi ¬kk ûÉ §„ � Þ ¨ ¹ Ç œØ Ý è
|
|||
|
|
ð ÷ › ¢ « ² œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã d Ãÿ m ÀŠ v ~ §„Í û Œ
|
|||
|
|
ç ë L ó‚ ½ „¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt•Áÿ ø ÀŠ ä€ ê€ §„ ¼ §„ æƒ # ó‚ × šŒ à ½… é ÀŠ ò ú �€ ¢ÀŠ t Áÿ } þˆ ÍQ‹ ä€ ¬k“ ê€ ÍQ¯ ¬k± û §„ � $
|
|||
|
|
î Ûƒß „ ·…§ ë…® ÍQ¬k§„` û “ y } Þ §„Š û ½ £ § 4096Á _Á "simplex has been closed"Á _Á _Á _Á _Áü¨Pè hÈã Ôÿ ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÈã ƒØ îÝ Èã ƒ �
|
|||
|
|
,ãO (ÚãO ‹– ÛêO Èã œµP dºP
|
|||
|
|
` $µP tºP ) $×P Û¼ ý• ü²PØ
|
|||
|
|
„±Q L¶Q
|
|||
|
|
a $±Q \¶Q ÛQ üùPt Ÿ Èã (ÝûQ
|
|||
|
|
ˆØ Ÿ Ÿ Çr ¢ ör £ …/ ¢³qÞƒÿd Èã x _ øÞùP‡ ù˜ † ù˜ ž£
|
|||
|
|
öX ù˜ ¸ Á Å
|
|||
|
|
Ò×
|
|||
|
|
„Øù˜ ê
|
|||
|
|
Œ
|
|||
|
|
ø ü
|
|||
|
|
|
|||
|
|
U
|
|||
|
|
" œØ¸• 9 E é
|
|||
|
|
È ¸• ÿ ÝÿQ ù˜
|
|||
|
|
ß�R ( �R œØ ¸• & } ù˜ y Ž � ¼ Ì 7 r € [ a v | h – øߨPè Ý ä  # Ð # ¡ ¨ Z » ù˜ Ó ‰R Õ Ý í ø ÿ o x ? l s y ?
|
|||
|
|
G W b i r
|
|||
|
|
| † � ÷
|
|||
|
|
Èã ) 0 7 > E L U _
|
|||
|
|
|
|||
|
|
®¥• r Ü ã µ ¼ $ š ¥• ¥ ÀŠ ® ‹– Èã êO Ä ‹– · ù˜ ù˜ 4 Ý
|
|||
|
|
Ý
|
|||
|
|
·m ß
|
|||
|
|
» à
|
|||
|
|
…/ רƄkUó À ‹– ³ Èã « ù˜ E | œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã¸• Ê „¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt•’š ’š ’š ÀŠ ½ ÀŠ Æ ÀŠ 2 : ¸• à ç ÀŠ S [ Ö û # ¸• l t þ $äO ‹– futÁà Èã
|
|||
|
|
®¥þ û– ù˜ � « è ù œØ (
|
|||
|
|
h 6 § y € Î� _ ¥• h ÀŠ q y ù˜U 2 û ¨P Þ å£ Á „¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt•£• ü ÀŠ
|
|||
|
|
‹– j Èã W ù˜ V ù˜ � û¢ × Èã ¹ å£ z ³¤ ƒ ’š Œ ÀŠ • � ¸• CÀŠ ¯ ¸• ‰
|
|||
|
|
‘
|
|||
|
|
£• š
|
|||
|
|
þ¥
|
|||
|
|
& ‹– ®¥ Èã 0
|
|||
|
|
®¥! û¹ ù˜ � Î ¥—
|
|||
|
|
ƒ˜» ò˜S ŒšZ Àša ù˜ùù˜ ÈãêÈãñ ®¥ù˜- û Ð ç ë ù˜W û ú × ü¦X3 lÈã Ôÿ ¸•îÝÈã 2 ? áâW îÝ îÝ âèW Èã $°X îÝ ì°X œµX
|
|||
|
|
eÈã 3 ÉX
|
|||
|
|
ĵX (äÎX
|
|||
|
|
ˆØ¥• N
|
|||
|
|
% øå°X# ¥• D K ¥• ch
|
|||
|
|
öX£• z ƒ ‡
|
|||
|
|
”™
|
|||
|
|
„Ø¥• ¬
|
|||
|
|
ˆ º ¾ Ê È ã œØ¸• ù â È ¸• äÒX ¥•
|
|||
|
|
|
|||
|
|
æØX îÝ ÙX œØ ¸• & f ¥•
|
|||
|
|
b îÝ Š – �
|
|||
|
|
Ø
|
|||
|
|
æ Á Ç Ü â l ü øæ¦X3 B I ' 5 R Y q l ¥• „ ØX € ˆ ‘ îÝ © ± Ì Õ è d
|
|||
|
|
k â ê ó îÝ '
|
|||
|
|
1 ; E ` i s } Èã ” Èã « îÝ À Ç Î Õ Þ è
|
|||
|
|
|
|||
|
|
®Ö¬ û ÿ > E # Ö¬ . ÀŠ 7 îÝ $âW Èã èW ¥• ƒ ¥• ¾ ‹– à Èã ± ¥• ~ € · å£ À Ù¨ É £• Ò £• Û ÀŠ » ÀŠ Ä ÀŠ ö þ ¸• Þ å ÀŠ $ , ¸• ) 1 þ< îÝ ®¥ Èã + îÝ ®¥7 û“ ¥• � ¨ « ¼ Ê œØ à ë
|
|||
|
|
l ù ý < C Î� " Ö¬ + ÀŠ 4 < îÝ ¥•Z û ¦X B F ¥ å£ ˆ „¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt•Ô¬ à ÀŠ Ì Èã ‹¥•
|
|||
|
|
¥• H ‹– j å£ ( Ù¨ 1 £• : ÀŠ C K ¸• +ÀŠ ] 6 Ô¬ ? þJ îÝ ®¥ Èã 9 îÝ ®¥E û¡ ¥• � ¶ ¹ ò% ¤®ú ƒ¯ ´¯¥•ìîÝÖ¥•úîÝä ®¥îÝÈ Èã g û Ä h îÝ Ò¾U û û < @ Ÿ _Á _Áüö ê ¬çº Ôÿ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¸M¸M OwnedPermitÁ ºM chanÁ›M ãº:%U 4çºáãۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ©M©M ék «Mæ¿›M i x‹–4Ðƒçº 4 B ê¯ �Á �Á $‚
|
|||
|
|
�Á Tü J ùÜž"#ùïž"#
|
|||
|
|
°c ù×µ.# ZÆ” 9 4–
|
|||
|
|
�ÁÛ ÔÁ ü¡
|
|||
|
|
# lµ
|
|||
|
|
|
|||
|
|
ôMçº 4¡
|
|||
|
|
|µ
|
|||
|
|
(ìÒ
|
|||
|
|
|
|||
|
|
ˆØöMçº Ôÿ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÈÀÛ\Û\ Ü\ SendErrorÁ Þ\ˆ Ò*¬û¥?Qh ÔÁ î È øí¡
|
|||
|
|
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 �Á Þy… ûs ¡Ä � ˆ •
|
|||
|
|
¦
|
|||
|
|
´
|
|||
|
|
œØ Ê
|
|||
|
|
Õ
|
|||
|
|
|
|||
|
|
¬ ä
|
|||
|
|
d _ À Ç Î�
|
|||
|
|
æ¿ ÀŠ ' �Á. ¡Ä; ‚¸û ö À Ä + œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãú¿ º „¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt•ä¿ õ ÀŠ þ ô ÔÁ )
|
|||
|
|
¡Ä à ¡Ä
|
|||
|
|
²Ð ò €Ñ û ¤Æ
|
|||
|
|
ÀŠ
|
|||
|
|
|
|||
|
|
µÄ R ÀŠ '
|
|||
|
|
ÀÈ H ¦ ®Ò Ï
|
|||
|
|
ú¿ � ‰ ä¿ ’ þ� ‚¸¡ �Á ‚¸´ �Á Þyì
|
|||
|
|
ûÚ ¡Ä � ï ü ”Ã^ ìà šÄÝ
|
|||
|
|
žÆä
|
|||
|
|
×Æë
|
|||
|
|
¡Ä% ®Èæ ²Éo¡Ä: ‚¸�ÁG çºõM[
|
|||
|
|
‚¸û ß ã J �Á‡ ©Ú”
|
|||
|
|
‚¸û Y ƒ IJ ´çº Ôÿ ú¿ , 9 ùá½D# Áá½#
|
|||
|
|
àW ùáÖ*# (Æ” 4 ƒ Ž – › ¯ ´ ½ È Õ å í ö ÿ
|
|||
|
|
|
|||
|
|
®ªÛ ªÛ ( ÀŠ 1 í ú¿ @ H þS \ m { œØ ‘ œ
|
|||
|
|
´ « Î� ¸ ªÛ Á ÀŠ Ê Ò ² Ê ÅÖ þ „¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt•¨Û 9 ÀŠ B þ Q ¨Û Z þe n úÛ. ¤ ¢ ¥ ¸ ¶ ¹ @ 64Á @ MAX_BUFSÁ _Á _Á¬÷
|
|||
|
|
‘ ’ % ‘· 1 8 ? $û~ Ô Ø % ¨È 1 8 ? Ý; ô ø % ‰Ì 1 ÞÌ 9 @ ½F ’ – % €Ï 1 ÞÌ 9 @ Ü— ñ çº ò ) áã 5 ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙçº ‚ ‰ $þ ø çº û ) ´ä 5 ÔÁ = D \¢ ø çº € ) ´ä 5 ÈÀ = D Ôº � çº � ) þå 5 „ „ ¯$ ‡Ø$ ö GgïkÆ) ú¿ m t $¿ – ÎéÖÑ š - †é 9 Îé A H ,Ì – ÎéÖÑ � - †é 9 ÖÑ A H üº " ø çº ù * »ê 6 ÑÛÑÛ MaybeUninitÁ ÓÛ uninitÁÝ ÔÛ»Ý Íõƒ«%9çº � ” ´ð¦ÐÒšÀ à ,¶ ïü Ø ü±% " Utilities for working with Tokio.Á ×ú üÛ9 6 This crate is not versioned in lockstep with the coreÁ ü•@ = [`tokio`] crate. However, `tokio-util` _will_ respect Rust'sÁ üÖK H semantic versioning policy, especially with regard to breaking changes.Á ü¿ üá"|¥ ´ð¦ÐÒšÀ| à } ïš� <° ´ ´ L
|
|||
|
|
Ä , , * , 8÷ $! & % 8÷ $&
|
|||
|
|
+ *. 1  , ; < » + J K b 8â L O a 8» <P X 7÷1 <Z + p q Ÿ 8ä Dr z ž 8 docsrsÁ 4{ $ � 8Ó ƒ † � 8â ‡ Š œ 8» <‹ “ 7÷1 <• , 8÷ $®
|
|||
|
|
¼ ¼ÇTÔ ß Ž å ô , æ ç ò , è 8÷ $é & í 8÷ $î
|
|||
|
|
ó *ö ù Œ , ƒ „ … + ’ “ « 8â ” — ª 8» <˜ 7Œ D¢ + ¹ º é 8ä D» à è 8ìí 4Ä $ Ê 8Ó Ì Ï ç 8â Ð Ó æ 8» <Ô Ü 7Œ DÞ , ÷ 8÷ $ø
|
|||
|
|
† ¤‘<ž ¦ ÿ ¬ » , ® ¹ , ¯ 8÷ $° & ´ 8÷ $µ
|
|||
|
|
º *½ À ý , Ê Ë ö + Ù Ú ‡ 8â Û Þ † 8£ ß â … 8» <ã ë 7ê ,í $ ò 8» <ô ü 7÷1 <þ + • – Ú 8ä D— Ÿ Ù 8ìí 4 $ ¦ 8Ó ¨ « Ø 8â ¬ ¯ × 8£ ° ³ Ö 8» <´ ¼ 7ê ,¾ $ Ã 8» <Å Í 7÷1 <Ï , è 8÷ $é
|
|||
|
|
÷ œ‚4� – ½ œ « , � ž © , Ÿ 8÷ $ & ¤ 8÷ $¥
|
|||
|
|
ª * ° » , º » ´ + É Ê Þ 8â Ë Î Ý 8» <Ï × 7•R $Ù + ì í ˜ 8ä Dî ö — 8ìí 4÷ $ ý 8Ó ÿ ‚ – 8â ƒ † • 8» <‡ � 7•R $‘ , ¦ 8÷ $§
|
|||
|
|
µ œ½4Ê Ñ ø × æ , Ø Ù ä , Ú 8÷ $Û & ß 8÷ $à
|
|||
|
|
å *è ë ö , õ ö ï + „ … ™ 8â † ‰ ˜ 8» <Š ’ 7Ø $” + § ¨ Ó 8ä D© ± Ò 8ìí 4² $ ¸ 8Ó º ½ Ñ 8â ¾ Á Ð 8» <Â Ê 7Ø $Ì , á 8÷ $â
|
|||
|
|
ð ¼û Tˆ
|
|||
|
|
“
|
|||
|
|
… ™
|
|||
|
|
¨
|
|||
|
|
, š
|
|||
|
|
›
|
|||
|
|
¦
|
|||
|
|
, œ
|
|||
|
|
8÷ $�
|
|||
|
|
& ¡
|
|||
|
|
8÷ $¢
|
|||
|
|
|
|||
|
|
§
|
|||
|
|
*ª
|
|||
|
|
|
|||
|
|
ƒ , ·
|
|||
|
|
¸
|
|||
|
|
ü
|
|||
|
|
+ Æ
|
|||
|
|
Ç
|
|||
|
|
à
|
|||
|
|
8â È
|
|||
|
|
Ë
|
|||
|
|
ß
|
|||
|
|
8”
|
|||
|
|
Ì
|
|||
|
|
Ï
|
|||
|
|
Þ
|
|||
|
|
8» <Ð
|
|||
|
|
Ø
|
|||
|
|
7Ø $Ú
|
|||
|
|
, î
|
|||
|
|
8÷ $ï
|
|||
|
|
|
|||
|
|
ý
|
|||
|
|
¬ˆ D• ž É ¤ ³ , ¥ ¦ ± , § 8÷ $¨ & ¬ 8÷ $
|
|||
|
|
² *µ ¸ Ç ,  à À + Ñ Ò è 8â Ó Ö ç 8» <× ß 7Ò 4á + ö ÷ ¤ 8ä Dø € £ 8ìí 4� $ ‡ 8Ó ‰ Œ ¢ 8â � � ¡ 8» <‘ ™ 7Ò 4› , ² 8÷ $³
|
|||
|
|
Á Dº $¾ œx $‡ K £ †J ¤,¨ µ> ¥T¯ ½T L— :<+- dŽ ô Synchronization primitivesÁ $– •ÑöÜlLa Ó
|
|||
|
|
�€mdw ×
|
|||
|
|
Ž‘Œ… J �·m̘ Ý
|
|||
|
|
�Ðpô· ‚ ‘Çr¼þ Ÿ “Ãuä— Ì ”ùwlÐ ñ ÏÄyTß ‡ ÐÑ!l™ à õ¯$ŒÑ „ ³´ ”$"JÝ
|
|||
|
|
‚ Ÿ Ì á
|
|||
|
|
… ¤ Ð K Ú †J @ ©,lð ø A ¢ FutureÁ4‘ ‚Ø B¦‹ ¨ „¾ Ck<¾ Ì� E·$Ç œØ FÜlLÚ Ó
|
|||
|
|
G€mdô ×
|
|||
|
|
H pin_projectÁ\˜ I¤ƒ ,’ Ó
|
|||
|
|
‘Œ J �ôtÐ »Ü ü²) üåH E Returns a reference to the cancellation token wrapped by this guard.Á,¹ ¾ ¾»Ü ¾îÝ ¿
|
|||
|
|
$Àü†, üÒ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¨ ×
|
|||
|
|
‘Œ J �ôÌÀ Ÿ úÜ Åü) üàHÍ…,´ À ÀúÜ ÀîÝ º
|
|||
|
|
Ÿ$»ü�0 üÍJû† üœFχ ¬çžˆ4ˆ úÜ ŸîÝ
|
|||
|
|
Ÿ$“ô¤ 8 Á Á ´Ý! �" ! ”É$Ì Â Â´Ý Ñ
|
|||
|
|
! 8$Öl³ L· '-3456:;<=?K £ †J " $ ¤,¨ µ> " % ¥T¯ ½T " & Œ�CE13 !Ô» DÍ ' ' á (ð " )ü " g/4¬Š7ÉÜ g/4¬Š7ÉÜ ()œÜ,Ü" ' ' µ>µ> ¤ ·>ð£> ¸> poisonÁ£> ¹>‚¸£> Ë»™z™g— - - ¢ .® " /» " 0Ì " 1Û " 2î " ‰££’¢!k Ôõ,õ" ' ' Ï]Ï] NotifyÁ Ð]º™S Ñ] waitersÁ™S õ�ÑÆ� 7ý l“ †�+, ܧ µ †� * *
|
|||
|
|
+ üòCD€ à Æ� û]û] NotifiedÁ ý] notifyÁ™S þ]º™S ÿ] notify_waiters_callsÁ™S €^ waiterÁ™S €‘F¦”åù� à * ‰ *
|
|||
|
|
, $Šdâ ,é" ²� ‰££’¢!k ./012ìõ4õ" - - ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ†J†J K ‰Jµ �7 ŠJ phantomÁ�7 ‹J¤�7 ·0ØQd�è†�çEçEèE GlobalÁ ¿±‡§í# Œ˜T˜" - - ä¯D¯" - - ªBªB ö B¬k÷< ®B‘÷< 9)
|
|||
|
|
-ÜnL‡•×•”ÑdÑ" - - ”é\é" - - ü±8d¿ Ä Ä‡• Ò
|
|||
|
|
3 nodeÁ$Ìü´AT ŠŇ• ‡• Õ
|
|||
|
|
4 ®4ÍüÕ"(œØ" " Æ Æ²� ò"
|
|||
|
|
5 è–$ì"üÑ+žÜÔ+ " É É‡• ÈãÛ — 7 Û 8 8 7 þ+ ÍìÈã ð+ ÍìÊ™ ó+ Ç È –"Èã½T½T ¥ ÀT lockÁ£> ÁT„�£> 0ªk¥a Dz�ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ½T½T ¥ ÀTÅ™£> ÁT„�£> 0ªk¥a Ȳ� ü«,C Ç È Èã°š˜" Ê™ ë,
|
|||
|
|
6ÈãÊ™è–$ø+ funcÁ$Ž,MP KN ¼ú,d…-ü¡=@¼¤= " Ê Ë Ê²� ˲� Â=
|
|||
|
|
: è–$¼=®4Î=ü BDd£B " Ì Í Ì²�½T½T ¥ ÀTÅ™£> ÁT„�£> 0ªk¥a Ͳ� ¸B
|
|||
|
|
; ®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´Ç •Ôã †¤ƒ pt� bT± VYHK„Ó >¼é 2ì† äá ü¦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());Á ,Ó }Á <Ù ```Á Œì îÝ |¯-Yñ‚
|
|||
|
|
x K Yü„
|
|||
|
|
,„
|
|||
|
|
J J ‡•ü¨
|
|||
|
|
1 îÝ üÝ
|
|||
|
|
4 îÝ üÊ + îÝO Àc O üü D ÿ Ñ Ò Ó ÑîÝ Ò c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
ÓÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ŸÈŸÈ È• O˜éBL N ƒ N
|
|||
|
|
O $„ ± Š üÇ îÝQ Ù Q ¼ÿ üî I F Creates a clone of the [`CancellationToken`] which will get cancelledÁ ü¼ > ; whenever the current token gets cancelled, and vice versa.Á,‚! Ô ÔîÝ îÝ P ˆ! P
|
|||
|
|
Q $‰! ü©"$ îÝS ·ß S ü€%/ üÔ"L I Checks if two tokens are equal in terms of their cancellation operation.Á ¥# ú ü#` ] Two tokens are considered equal if cancelling one will always also cancel the other and viceÁ ü’$S P versa. This is only true for cloned tokens and not for tokens in a parent-childÁ Œê$ relationship.Áƒ% Õ Ö ÕîÝ ÖîÝ R †% R
|
|||
|
|
S $‡% ¹
|
|||
|
|
,�% ìê% îÝ üŒ&+ îÝV ›e V üÌ&4 $Ï& × Ø ×îÝ Ø ™ U ™ W W ë& U Íìò¹ Ô& ¢eò¹ ”×&
|
|||
|
|
Vò¹$ì& º,ò& +- üº' îÝY �" Y ”à' $ã' Ù ÙîÝ X è' X
|
|||
|
|
Y $í' ü¸(" îÝ[ ´ [ üá(! <ä( îÝ Z Z
|
|||
|
|
[ ´¯) îÝ]^_`abcdei ü”*! üÌ)C @ Creates a new [`CancellationToken`] in the non-cancelled state.Á ›* îÝ \ \
|
|||
|
|
] üú5. ü¢+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();Á ˜0 ú ü 03 ï¨ üØ0? ¬© ¬œ1 ô© ü¶10 - _ = child_token.cancelled() => {Á üë1. Ϊ ¬ž2 …« Œ¸2 £« üÎ2Q ¾« ´¤3 ˜¬ Œ¿3 £« lÕ3 Ĭ \ç3 Ú¬ ÷3 ú üÿ3! û¬ ü¥4K ¦ Üõ4 ú \•5 Ú¬ ¥5 ú ü52 ¸® ,ä5 ó® <î5 �¯\�6 Ú ÚîÝ îÝ \ �6 \
|
|||
|
|
^ $Ž6 ¤Ø; ü“7H E Cancel the [`CancellationToken`] and all child tokens which had beenÁ ¤à7 derived from it.Á ù7 ú ü�8C @ This will wake up all tasks which are waiting for cancellation.Á É8 ú üÑ8I F Be aware that cancellation is not an atomic operation. It is possibleÁ üŸ9K H for another thread running in parallel with a call to `cancel` to firstÁ üï9J G receive `true` from `is_cancelled` on one child node, and then receiveÁ ü¾:H E `false` from `is_cancelled` on another child node. However, once theÁ ü‹;H E call to `cancel` returns, all child nodes have been fully cancelled.Á4ß; Û ÛîÝ \ æ; \
|
|||
|
|
_ $ç; üâ<" ü¢<; 8 Returns `true` if the `CancellationToken` is cancelled.Ádé< Ü ÜîÝ \ ö< \ ¥—$÷< üÅ@8 ü¿=L I Returns a [`Future`] that gets fulfilled when cancellation is requested.Á �> ú ”˜> Equivalent to:Á ¯> ú l·>
|
|||
|
|
```ignoreÁ ôÉ> async fn cancelled(&self);Á <ì> �¯ ø> ú ü€?J 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Ì@ Ý ÝîÝ Ý
|
|||
|
|
Ý
|
|||
|
|
·m ß
|
|||
|
|
» à
|
|||
|
|
…/ רƄkUó Ý \ Ö@ \ ƒ˜$×@ üøE> üŠBL úÊ ÛB ú ”ãB ÛË úB ú l‚C ‚Ì ü”C# async fn cancelled_owned(self);Á <¼C �¯ ÈC ú üÐCJ ÙÌ üŸD Í ÃD ú üËDG D The function takes self by value and returns a future that owns theÁ T—E token.Á ¦E ú Ì®E áÍ ÌE ú üÔE �Î|ÿE îÝÂß \ \
|
|||
|
|
b $�F ü”H$ üöF+ ( Creates a [`DropGuard`] for this token.Á ¦G ú ü®GH E Returned guard will cancel this token (and all its children) on dropÁ ¤ûG unless disarmed.ÁT›H îÝ»Ü \ \
|
|||
|
|
c $¦H ü�J0 üîH. + Creates a [`DropGuardRef`] for this token.Á ¡I ú ü©IH ŒÓ ¤öI ÝÓt–J Þ ÞîÝ ×
|
|||
|
|
×
|
|||
|
|
€m Ù
|
|||
|
|
ð °wØýòká Þ \ ¥J \
|
|||
|
|
d $¦J ü¿Od üøJT Q Runs a future to completion and returns its result wrapped inside of an `Option`Á üÑKT Q unless the [`CancellationToken`] is cancelled. In that case the function returnsÁ üªL' $ `None` and the future gets dropped.Á ÖL ú tÞL # FairnessÁ ñL ú üùLG D Calling this on an already-cancelled token directly returns `None`.Á üÅMB ? For all subsequent polls, in case of concurrent completion andÁ üŒN? < cancellation, this is biased towards the future completion.Á ÐN ú ÌØN áÍ öN ú üþN< 9 This method is only cancel safe if `fut` is cancel safe.ÁœÌO ß ßîÝ ÈãÈã ß g \ — f f ãO \ ù™ àO ‚ØÈã 4œP òc[®¥5]&( ˆàõO e8 ® ® e hÈã Ôÿ ¸• 8îÝ Èã ÍìÈã 8 g ] ‚ØæÝ l æÝƒØ ¸•~ ÞÝ„ øÝŠ ‡Þ� e ›d e <coroutine_kind>Á h <resume_ty>Á h
|
|||
|
|
<yield_ty>Á h <return_ty>Á h ùŸ h h e ¥•ü¸Wi ü–RT �Ö üïRT ûÖ üÈS' Ù× ôS ú üüSN K The function takes self by value and returns a future that owns the token.Á ÏT ú t×T •Ø êT ú üòTG ¹Ø ü¾UB ŠÙ ü…V? ÖÙ ÉV ú ÌÑV áÍ ïV ú ü÷V< ÄÚÌÅW îÝÈãÈã k \ — j j \ ù™ ßW êÜ4šX
|
|||
|
|
iÈãªU®¥¨U"$ ˆçóW i i Ö¬ Íìïá # ‚Øïá 2 ïáƒØ ¸•D ÞâJ íâP üâV i ^[ iÊÝ l äÝ l ùÝ l �Þ l ùŸ l l i Ö¬üŒY; Ÿ n n üÞo Àc o ‘Y üÎYD ÑY à á â àüÞ á c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
⓲ m ÕY m
|
|||
|
|
o Ÿ$ÖY ± ÜY üÛZ1 Ÿ q q üÞrs ƒØ „Ø s àZ \“[ 4˜[ p p üª[? $[ ã ä 儾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ãüÞ äÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å åÎ� p ¼[ p
|
|||
|
|
s Ÿ$²[ cxÁÈ[ ü¤a8 Âßu Àc u üãaD æa æ ç è æÂß ç c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
蓲 t êa t
|
|||
|
|
u $ëa ± ña üõb# Âßwx üŸc5 ¢c îÝÂß v v
|
|||
|
|
w »”¦c üìhv Töh é éîÝ û]û] æ‘ ý]÷‘™S þ]º™S ÿ]•’™S €^µ’™S €‘F¦”åù� v ži v
|
|||
|
|
x »”Ši ü¹l. Âßz{ ƒØ „Ø { \îl 4ól y y ü…m? $ˆm ê ë 섾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• êÂß ëÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ìÎ� y —m y
|
|||
|
|
{ $�m Èç£m ü¯w2 Ÿ } — ~ } ~ Íì¶Ò ¸w ‚Ø¶Ò 4»w ìá ´w !# üèwO öw ㌶Òìá | |
|
|||
|
|
Ÿ¶Ò»”úw …/4¥x üªy= Ÿ � — ‚ � ‚ •ï ³y ¦ï4¶y ìჄ ƒØ „Ø „ ¯y *, \îy 4óy € € ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ¶Ò ƒØü”zI $—z í î „¾ ¦‹ †¾‰ ˜X $ ]È=„kt• íìá îÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ïœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãìá ƒØ € ¦z €
|
|||
|
|
„ Ÿ¶Ò$œz Èç²z ü¢€: — † † ù™ §€ êÜ4ª€ �㇈ ƒØ „Ø ˆ &( \〠4è€ … … ¸•ü‰�I $Œ� ð ñ ò„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ð�ã ñÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å òœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã�ã ƒØ … ›� …
|
|||
|
|
ˆÈã$‘� Èç§� üêƒ/ — Š Š ù™ ïƒ êÜ4òƒ �ã‹ ü „K ®„ îÝÈã�ã ‰ ‰
|
|||
|
|
‹Èã»”²„ …/4Ù„ ”@„Z”;¼l‰;{;~;p;s;d;g;”é\;_;N;Q;D· $»©®ñ ò ‡ ø � � SinkÁ$
|
|||
|
|
• –¦‹ & „¾ • —k<; Ì� • ™·$D œØ • š× U ¤, • œí Z ë • �Ò¿\w ¸M • žék4› ©M • Ÿ¯$Œ¯ „ • ³” ½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¬k ` àB¤GS
|
|||
|
|
õ“² ¤ µ ¤
|
|||
|
|
¦çº$¶ × ¼ üš: ¥ ¨ ¨ Âü Ÿ ¿cçº T¢ áã üŠ k œ“ • �Áçº « ¥ ª ª Âü §
|
|||
|
|
©çº‚¸cY øñÍ ( © © æ¿ Í솂 & ‚؆‚ 5 †‚ƒØ ú¿G ê‚M ù‚S ˆƒY © Üa ©ÊÝ ¬ äÝ ¬ ùÝ ¬ �Þ ¬ ùŸ ¬ ¬ © æ¿ í
|
|||
|
|
©ÄŸ ÜŸ ùŸ © Àȼâ \ç • Ÿ ¯ ¥ ° ¯ ° ÍìÅ» ÷ „ „ ¯$ ‡Ø$ ö GgïkÆ) ŸÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¸M¸M Ò¿ ºMæ¿›M ãº:%U 4Å» ñ ñ ò ùw ô ˆ • y×é¾ÀÉSnÅ»ó õ÷ Üð ¥ ² ² Âü õ þå³
|
|||
|
|
”Ò ,Õ • þå ± ±
|
|||
|
|
³çº,² ³ÊÝ ´ äÝ ´ ùÝ ´ �Þ ´ ùŸ ´ ´ ³ ªÛüÖ! ¥ ¶ ¶ Âü Û Ììçº $Þ þå·¸¹ "$ „© ¬ • þå µ µ
|
|||
|
|
·çºüÏZ $Ò • ö ÷ ø öþå ÷Ì�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å øÅÖ µ × µ
|
|||
|
|
¸çº$Ü Èçâ üñ, ô • ù ùþå�Á µ ø µ
|
|||
|
|
¹çº$ý Þy4ƒ Ü€ ¥ » » Âü … «‰$ˆ å¼½¾¿ÀÁÂà (* üÆ % ü¢ Creates a new `PollSender`.Á Í ÔÁå º º
|
|||
|
|
¼çºÞy4Ñ ü’ $ 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¬k ` àB¤GS
|
|||
|
|
ž“² ñ ž, ñ
|
|||
|
|
ò $Ÿ,± ¥,üÊ-' Óæô â ô ôø-4û- Ÿ ŸÓæ Ÿ®ç ó ‚. ó
|
|||
|
|
ô $ƒ.쉲l„© 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.Á Œú Ÿ … ¥ † † … —… � „ „ ¯$ ‡Ø$ ö GgïkÆ) ŸÅ» GgïkÆ) ‡Œ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� ö ¢ ¢ „ „ ¯$ ‡Ø$ ö GgïkÆ) Ÿéñ¶ÒÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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¬k ` àB¤GS
|
|||
|
|
¯“² � Ç �
|
|||
|
|
Ÿ 8Å»$ȱ Îü¹…l¼ ö „¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt•�� ž²â ¡ˆˆ ¢‰ˆ l }.xÏçº×•íº—Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
íº ¥ ¡ ¦ ¢ £ — ¤ £ ¡ ¤ ¢ Îìçº Ê Íìíº Õ ÍìÓÿ Ø Íì€ÿ Û –"€ÿ�� ž²â ¡ˆˆ ¢‰ˆ l }.xÏíº×• œª €ÿó€˜" Óÿ ¼
|
|||
|
|
çºíºÓÿ€ÿØ$,Þ new_valueÁLò callbackÁD€åç áã Ýß ÙÛ ¶ ÄŸ ¥ ÜŸ ¥ ùŸ ¥ ¥ ¥çºíºÓÿ€ÿ Óÿ çº íº€ÿüÀ#& TÇ#ö § — ¨ ¨ § Íìõè Ò# •ï Õ# –"¶Ò lØ# ¶Ò ˜" õè ä#Çè (ƒìÍesX © ²RT WY ”í# í#ö ¦ ¦ ÃÛÃÛ ©Ý ÅÛ»¬ „ µÜÀ,�%*¶Òü„$* « — ¬ ¬ « ®„ ›$ •ï Œ$ ›„l�$ ‚„ ‰$Çè® +- ¤µ$ ¸$ ö ¶ÒÇè ª ª
|
|||
|
|
õè¶Ò± ¼$”�%$’% ö Çèõè ª ª
|
|||
|
|
®õè¶Ò$—%ü¥&3 ° — ± ° ± ®„ ¼& •ï & ›„l°& ‚„ ª&Çè² �" ² 02 ”ß&$â& ° °Çè ¯ ç& ¯
|
|||
|
|
²õè¶Ò$ì&üà ‚t� ü # Module defining an Either type.Á 4¥ – æƒ4; ‚Ø ´ ¶ SeekFromÁDK ñL ´ ·¦‹ ^ „¾ ´ ¸k<n Ì� ´ º·$w œØ ´ » AsyncBufReadÁd‘ v ´ ½ AsyncReadÁLŸ ’ ´ ¾ AsyncSeekÁLª « ´ ¿
|
|||
|
|
AsyncWriteÁTµ Å ´ À ReadBufÁ<Á û ´ ÁÍ4Ê Ý ´  (t3 dGDYùü(CëíÚÜL…Á誎�su[]JLÔÉlÖ ä “ ê –
|
|||
|
|
, ë 8 $ì & ð 8¼ ,ñ ö , ÷ 8 methodÁ 4ø & þ 8¼ ,ÿ „ • , … † ’ , ‡ 8À $ˆ & Œ 8¼ ,� $ “ ” *˜ › ‘ 8" 4¥ ¬ ‹ 8 ,º , À 8 $Á Å 8 get_unchecked_mutÁ ŒÆ × Ø Ú � 8 $ì 'ð 8øz $ò ö ø 8· ÷ *ú 8¦‹ ý '€ 8ð l‚ � ‘ 8· � ’ , “ 8–Œ 4” š ¥ , › œ ¢ , � 8À $ž $ £ ¤ $ ¦ 8 $¸ '¼ 8‘{ ,¾ à Š8½ Ä *Ç 8¦‹ Ê 'Í 8ð lÏ Ü Þ 8½ Ý ß , à 8–Œ 4á ç ò , è é ï , ê 8À $ë $ ð ñ $ ó ü–a � Å £ Æ Ç Æ Å Ç ÎéƒØ ÓÿTÐ ÖÑƒØ ÓÿTë Æ€ ¡ ‚ØÎé ”É ÍìÎé › ‚ØÖÑ ”ä ÍìÖÑ ž†éÈÉ ƒØ „Ø É >@ )+ z| \þ4ƒ Ä Ä Óÿü”I$— ± ² ³„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ±†é ²Ì�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ³œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã†é ƒØ Ä ¦ Ä
|
|||
|
|
ÉÎéÖÑÓÿ$œÈç²ü�O � Ë £ Ì Ì Ë °“ ” Ò“ — ’Îé L ’ÖÑ LÔ†éÍ “ Í ;= @B üå‚Lè ´ µ ¶ · ¸„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ´†é µÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ¶ ·ûû ÕŠ ý¬kø þ filledÁø ÿ initializedÁø §Ã‰ˆ¾0œŸ ¸œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÞÌ Ê … Ê
|
|||
|
|
ÍÎéÖÑ$ûÈ癬k ·ü£X � Ï £ Ð Ï Ð °“ ¨ Ò“ « vÎé dÙ vÖÑ dî†éÑÒ w x Ò Ñ 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 Ï ó‚ Ø ¤" Ø
|
|||
|
|
ÞÎéÖÑ$š"Èç¸"â�$Ö"ü÷##Œú# РІé Ø Œ$ Ø
|
|||
|
|
ßÎéÖÑ$�$ü®%˜ � á £ â â á ÖÑ$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Ú]¾å Ýý¾ å Ý- å
|
|||
|
|
îÎéÖѮꔻ$Ó-Èçñ-p®s®D¾ $ ñ‡Šª « ® ©,l¢ ø ¢’.l¬ š ¤·.t» � ¥k<˜ Ì� ð ¨ ·$¡ œØ ð © ” tðøùæƒ4 ‚Ø ñ òîç\) ÑÛ ñ ó¦‹ E „¾ ñ ôk<[ Ì� ñ ö·$d œØ ñ ÷¤j´ Yt:HTN9;(*G° lÌ ¥ ú ú Âü Ú »ê l�j«?¡P ù û âè»ê þ�°T ñ âè»ê ø ø
|
|||
|
|
ùçºoq tÝ ñ ø ø âèüï ! ¥ ý ý Âü ô »êþ �" þ ”—
|
|||
|
|
$š
|
|||
|
|
Þ Þ»ê ü Ÿ
|
|||
|
|
ü
|
|||
|
|
þçº$¤
|
|||
|
|
Ä¥ ¥ € € Âü ª »ê�
|
|||
|
|
üÄ # Ò çº»ê ÿ ÿ
|
|||
|
|
�çºð,Ö ü™ + — ƒ ƒ ù™ ž êÜ4¡ ùê„… ƒØ „Ø … $& \Ë 4Ð ‚ ‚ ý•üé I$ì ß à ᄾ„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ßùê àÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å áœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãùê ƒØ ‚ û ‚
|
|||
|
|
…Èã$ñ Èç‡
|
|||
|
|
4• …ÄŸ † ÜŸ † ùŸ † † … †Èã ùê Èã ¬. »÷1ŒÌ 4= ˆ‰üð= ú $Ö»–„ÜÄÕüÌ#dó ‡ â âƒÑ ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ –
|
|||
|
|
ˆ needleÁ4€ haystackÁDŒüö
|
|||
|
|
B4„ ã ãƒÑ ’Ò ¡
|
|||
|
|
‰ ïÑ4‹ ýÑD— dt »•RtO»÷1Œ_üN#üE. Dxðš�ú‰L ’ Š Œ¶ŠT Å Š �ÕŠ<' û Š Ž BufÁ > Š � BufMutÁ4C ™ Š ‘•R$Z ¦ Š “ú²<` æL Š ”¦‹ x „¾ Š • ·,� ¥‚ Š —k<” Ì� Š ˜·$� œØ Š ™LðòßáÎÐ,6¾À©«<PœUŒŽln~L�np\^JLüæ ” ü¥U R Try to read data from an `AsyncRead` into an implementer of the [`BufMut`] trait.Á ûú Ôÿ [`BufMut`]: bytes::BufÁ šú lž
|
|||
|
|
# ExampleÁ ¬ú <°�¯ ü¸! use bytes::{Bytes, BytesMut};Á üÚ use tokio_stream as stream;Á Ôú use tokio::io::Result;Á ü•6 3 use tokio_util::io::{StreamReader, poll_read_buf};Á ìÌ use std::future::poll_fn;Á ´ê use std::pin::Pin;Á ü�/ , # #[tokio::main(flavor = "current_thread")]Á ü±. + # async fn main() -> std::io::Result<()> {Á àú üäN K // Create a reader from an iterator. This particular reader will always beÁ l³
|
|||
|
|
// ready.Á üÁh e let mut read = StreamReader::new(stream::iter(vec![Result::Ok(Bytes::from_static(&[0, 1, 2, 3]))]));Á ªú ü®" let mut buf = BytesMut::new();Á ´Ñ let mut reads = 0;Á èú Tì loop {Á œ÷ reads += 1;Á ü‹V S let n = poll_fn(|cx| poll_read_buf(Pin::new(&mut read), cx, &mut buf)).await?;Á âú œæ if n == 0 {Á ”ú break;Á L� }Á ,—ó® �ú ü¡, ) // one or more reads might be necessary.Á ÄÎ assert!(reads >= 1);Á üç( % assert_eq!(&buf[..], &[0, 1, 2, 3]);Á d� # Ok(())Á <� # }Á <¥ �¯ lí ä å æ 焾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• äçº åÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å æ çÂÙó‚ ¥ › “ œ œ › ª
|
|||
|
|
¤€ û ÍìÂÙ ’
|
|||
|
|
’çº Lþ ™ÂÙ 4•
|
|||
|
|
|
|||
|
|
šçºÂÙ•R¢
|
|||
|
|
Èç·
|
|||
|
|
¬k Ñ
|
|||
|
|
[] WY üÜ“ ü¯D A Try to write data from an implementer of the [`Buf`] trait to anÁ üô; 8 [`AsyncWrite`], advancing the buffer's internal cursor.Á °ú ü´M J This function will use [vectored writes] when the [`AsyncWrite`] supportsÁ ¤‚ vectored writes.Á —ú t›¥¦ ªú ü®G D [`File`] implements [`AsyncWrite`] and [`Cursor<&[u8]>`] implementsÁ dö [`Buf`]:Á ƒú l‡È¦ ü•' $ use tokio_util::io::poll_write_buf;Á ”½ use tokio::io;Á ÄÐ use tokio::fs::File;Á éú œí use bytes::Buf;Á ì�ÖØ ÄŸ use std::io::Cursor;Á ´¸üØ Ïú ”Ó¿§ üæ' $ async fn main() -> io::Result<()> {Á üŽ6 3 let mut file = File::create("foo.txt").await?;Á üÅ4 1 let mut buf = Cursor::new(b"data to write");Á úú üþF C // Loop until the entire contents of the buffer are written toÁ ¤Å // the file.Á üÚ# while buf.has_remaining() {Á üþS P poll_fn(|cx| poll_write_buf(Pin::new(&mut file), cx, &mut buf)).await?;Á LÒÞ Üú tà Ok(())Á ,ïó® <õ�¯ ýú ¼� [`Buf`]: bytes::BufÁ ü™) & [`AsyncWrite`]: tokio::io::AsyncWriteÁ ìà [`File`]: tokio::fs::FileÁ üáA > [vectored writes]: tokio::io::AsyncWrite::poll_write_vectoredÁ tã è é ê 넾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• èçº éÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ê ëÂÙó‚ ¥ ž “ Ÿ ž Ÿ Ÿ ¤€ ò ¿ã Š Åçº Tõ ÂÙ �
|
|||
|
|
�çºÂÙ•R—È第k ÆQS VX ¬öDüŠ D° � � ì’ðD¡ãæ×ÚtÉ ü R O An extension trait for Futures that provides a variety of convenient adapters.Á 4Ñ §Ê³|Ü� ¯ ¦ Ɖü¬ Ø ¦ Çæƒ4á ‚Ø ¦ È‘Œû J ¦ É �ÜT ¼X¦¯ Ø ³ Û æƒ4 ‚Ø § ©¦‹ ( „¾ § ªk<8 Ì� § ¬·$A œØ § â„\b § ®‘Œ‚ J § ° �Çr¼• Ÿ § ± “Ãuä® Ì § ² ” t¶D#¥ü1—™†ˆìPw\thjTV?Aü¨6 Ÿ ´ — µ µ ´ •ï ± ¦ï4´�ì¶ üåO ó ㌶Ò�ì ³ ³
|
|||
|
|
¶ Ÿ¶Ò»”÷…/4¢¢ ¶ÄŸ · ÜŸ · ùŸ · · ¶ · ¶Ò Ÿ Ÿ Çr ¢ ör £ …/ ¢³qÞƒÿd ¶Ò ‹–¶ÒüóA Ÿ ¹ — º ¹ º •ï ü ¦ï4ÿ�컼 ƒØ „Ø ¼ ø*, \» 4À ¸ ¸ ¤ñüá I$ä ì í „¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ì�ì íÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å îœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã�ì ƒØ ¸ ó ¸
|
|||
|
|
¼ Ÿ¶Ò$é Èçÿ üÃ3 — ¾ ¾ ù™ È êÜ4Ë‘í¿ üýK ‹ îÝÈã‘í ½ ½
|
|||
|
|
¿Èã»”�…/4¶¶ ¿ÄŸ À ÜŸ À ùŸ À À ¿ ÀÈã �ã í¬üŒ> —   ù™ ‘ êÜ4”‘íÃÄ ƒØ „Ø Ä $& \Ñ4Ö Á Á ¸•ü÷I$ú ï ð ñ„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ï‘í ðÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ñœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ã‘í ƒØ Á ‰ Á
|
|||
|
|
ÄÈã$ÿÈ畼uqtbeœÔUôîFÜè ü�X U A trait which contains a variety of convenient adapters and utilities for `Future`s.Á Lò Ê Ê Îì üè¶ ‚Ø
|
|||
|
|
Ï°
|
|||
|
|
É \Û ç ¸ ñ € , ò ó þ , ô 8÷ $õ & ù 8÷ $ú
|
|||
|
|
ÿ *‚ … ² , “ ” § + ¦ § À 8â ¨ « ¿ 8» <¬ ´ 7¾ L¶ + Ò Ó ƒ 8ä DÔ Ü ‚ 8ìí 4Ý $ ã 8Ó å è � 8â é ì € 8» <í õ 7¾ L÷ , • 8÷ $–
|
|||
|
|
¨ \ç »÷1ˆ PÈ J <ë ” ,
|
|||
|
|
z % , # , 8 argÁ & 8¯ !
|
|||
|
|
$ *' * w + 4 5 N 8â 6 9 M 8» <: B 7Ü1 LD 8Ü1 <X '_ 8ë1 ,a f g p , h i n , j 8½• k
|
|||
|
|
o % q % x lù ü 9 6 Adaptors from `AsyncRead`/`AsyncWrite` to Stream/SinkÁ :ú ü>K H Raw I/O objects work with byte sequences, but higher-level code usuallyÁ üŠA > wants to batch these into meaningful chunks, called "frames".Á Ìú üÐP M This module contains adapters to go from streams of bytes, [`AsyncRead`] andÁ ü¡K H [`AsyncWrite`], to framed streams implementing [`Sink`] and [`Stream`].Á üí0 - Framed streams are also known as transports.Á žú ü¢) & # Example encoding using `LinesCodec`Á Ìú üÐS P The following example demonstrates how to use a codec such as [`LinesCodec`] toÁ ü¤P M write framed data. [`FramedWrite`] can be used to achieve this. Data sent toÁ üõT Q [`FramedWrite`] are first framed according to a specific codec, and then sent toÁ üÊ% " an implementer 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`] implementer 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Ù¾¹ÞÌ Ý ‹
|
|||
|
|
Ý
|
|||
|
|
à $�
|
|||
|
|
¬k –
|
|||
|
|
üò
|
|||
|
|
"
|
|||
|
|
‘·âã ü ý ã T›
|
|||
|
|
,
|
|||
|
|
á á ÞÌü¸N
|
|||
|
|
4»
|
|||
|
|
õ ö õ‘·Ò¸ ö¾¹Þ› á Â
|
|||
|
|
á
|
|||
|
|
ã $Ç
|
|||
|
|
‚¸$Í
|
|||
|
|
¬k Ú
|
|||
|
|
üÙ%
|
|||
|
|
‘·åæ ü ý æ T…
|
|||
|
|
,Š
|
|||
|
|
ä ä ÞÌü¢Q
|
|||
|
|
4¥
|
|||
|
|
÷ ø ÷‘·¾¹ ø¾¹Þ› ä ¬
|
|||
|
|
ä
|
|||
|
|
æ $±
|
|||
|
|
‚¸$·
|
|||
|
|
¬k Ç
|
|||
|
|
ì‰cU\©c <cÒï³—4 × è é „ú‰L+ ’ è 붊T6 Å è ìȸDO  è í•Rb ¦ è î¤kL WYFH|H8<])Œâ
|
|||
|
|
üg# Decoding of frames via buffers.Á ‹ú ü�E B This trait is used when constructing an instance of [`Framed`] orÁ üÕO L [`FramedRead`]. An implementation of `Decoder` takes a byte stream that hasÁ ü¥H E already been buffered in `src` and decodes the data into a stream ofÁ Äî `Self::Item` frames.Á ‡ú ü‹D A Implementations are able to track state on `self`, which enablesÁ üÐM J implementing stateful streaming parsers. In many cases, though, this typeÁ üž= : will simply be a unit struct (e.g. `struct HttpDecoder`).Á Üú üà= : For some underlying data-sources, namely files and FIFOs,Á üž> ; it's possible to temporarily read 0 bytes by reaching EOF.Á Ýú üá? < In these cases `decode_eof` will be called until it signalsÁ ü¡> ; fulfillment of all closing frames by returning `Ok(None)`.Á üàO L After that, repeated attempts to read from the [`Framed`] or [`FramedRead`]Á ü°J G will not invoke `decode` or `decode_eof` again, until data can be readÁ œû during a retry.Á �ú ü“D A It is up to the Decoder to keep track of a restart after an EOF,Á üØ> ; and to decide how to handle such an event by, for example,Á ü— K H allowing frames to cross EOF boundaries, re-emitting opening frames, orÁ üã ( % resetting the entire internal state.Á Œ
|
|||
|
|
ú ü�
|
|||
|
|
$ ! [`Framed`]: crate::codec::FramedÁ üµ
|
|||
|
|
, ) [`FramedRead`]: crate::codec::FramedReadÁ <ì
|
|||
|
|
ï ï úƒüâ
|
|||
|
|
º4 ï úƒ úƒ ðñòóôðñòóô Íì‚„ ð Tž �£ Íì‚„ ñ ä é ·£ÞÌ |¬ ¯£ Ç£ ó ò ô Lž üú
|
|||
|
|
The type of decoded frames.Á$£ ï ï Ü ü® 4 1 The type of unrecoverable frame decoding errors.Á ç ú üï E B If an individual message is ill-formed but can be ignored withoutÁ ü¹ F C interfering with the processing of future messages, it may be moreÁ ü„
|
|||
|
|
. + useful to report the failure as an `Item`.Á ·
|
|||
|
|
ú ü¿
|
|||
|
|
L I `From<io::Error>` is required in the interest of making `Error` suitableÁ ü�K H for returning directly from a [`FramedRead`], and to enable the defaultÁ üàK H implementation of `decode_eof` to yield an `io::Error` when the decoderÁ ü°( % fails to consume all available data.Á Ýú üåJ G Note that implementers of this trait can simply indicate `type Error =Á ü´. + io::Error` to use I/O errors as this type.Á çú üï,Œ¡,¥ ï ï üŸ(T üÂA > Attempts to decode a frame from the provided buffer of bytes.Á ˆú ü�J G This method is called by [`FramedRead`] whenever bytes are ready to beÁ üßH E parsed. The provided buffer of bytes is what's been read so far, andÁ ü¬I F this instance of `Decode` can determine whether an entire frame is inÁ üú+ ( the buffer and is ready to be returned.Á ªú ü²I F If an entire frame is available, then this instance will remove thoseÁ ü€? < bytes from the buffer provided and return them as a decodedÁ üÄK H frame. Note that removing bytes from the provided buffer doesn't alwaysÁ ü”K H necessarily copy the bytes, so this should be an efficient operation inÁ ¼ä most circumstances.Á €ú üˆH E If the bytes look valid, but a frame isn't fully available yet, thenÁ üÕJ G `Ok(None)` is returned. This indicates to the [`Framed`] instance thatÁ ü¤F C it needs to read some more bytes before calling this method again.Á ïú ü÷D A Note that the bytes provided may be empty. If a previous call toÁ üÀG D `decode` consumed all the bytes in the buffer then `decode` will beÁ üŒP M called again until it returns `Ok(None)`, indicating that more bytes need toÁ dá be read.Á òú üúF C Finally, if the bytes in the buffer are malformed then an error isÁ üÅK H returned indicating why. This informs [`Framed`] that the stream is nowÁ ü• % " corrupt and should be terminated.Á ¿ ú üÇ $Þ üð ,Œ¡ ¡ ú ¼© # Buffer managementÁ Å ú üÍ J G Before returning from the function, implementations should ensure thatÁ üœ J G the buffer has appropriate capacity in anticipation of future calls toÁ üë 5 2 `decode`. Failing to do so leads to inefficiency.Á ¥ ú ü G D For example, if frames have a fixed length, or if the length of theÁ üù F C current frame is known from a header, a possible buffer managementÁ „Ä
|
|||
|
|
strategy is:Á Ù ú lá Ȧ ”ó # use std::io;Á ,Š! #Á Ô”! # use bytes::BytesMut;Á ü³!%‡Ä ,Ý!¡º ¬ç! # struct MyCodec;Á ,�"¡º ô‹" impl Decoder for MyCodec {Á t®" // ...Á üÁ" # type Item = BytesMut;Á üå"! # type Error = io::Error;Á ‹#ú ü“#] Z fn decode(&mut self, src: &mut BytesMut) -> Result<Option<Self::Item>, Self::Error> {Á ”õ# // ...Á Œ$ú ü”$H E // Reserve enough to complete decoding of the current frame.Á üá$< 9 let current_frame_len: usize = 1000; // Example.Á ü¢%4 1 // And to start decoding the next frame.Á üÛ%> ; let next_frame_header_len: usize = 10; // Example.Á üž&C @ src.reserve(current_frame_len + next_frame_header_len);Á æ&ú äî& return Ok(None);Á L�'Þ ,�'ó® <§'�¯ ³'ú ü»'E B An optimal buffer management strategy minimizes reallocations andÁ ¬…( over-allocations.Á4¢( ù ú ù‚„ ú¾¹Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÿ ‡â„\Ï ÿ ˆY4î ÿ ŠZLö £ ÿ ‹•R‹ ¦ ÿ Œ¦‹ � „¾ ÿ � ·,² ¥‚ ÿ �k<¹ Ì� ÿ �·$ œØ ÿ ‘ô>ô(0¤M!Lg|�ù”¥éì½Ú\àÌμ¾<†¯l“ŸL¦Ž�|~jlì‘„—ÿ äí Tÿ “½ +¸zŠÅ<‰ ”•Ü�4› “ “ ¾¹ü±'¬¼ “ “ ÔÒ ô»— ´ — ¤ó<ö ô» – –
|
|||
|
|
— Üà “½™ ´ ™ ¤å <è “½ ˜ ˜
|
|||
|
|
™ ü’ ! ô»› ë › üº %$½ ¾¹ô» š š
|
|||
|
|
› ü54Æ ü¢" “½� ë � üË%$Î ¾¹“½ œ œ
|
|||
|
|
� ü54×üé# ɼŸ ¢ Ÿ ô“4– ÿ ÿɼ ÿô» ž � ž
|
|||
|
|
Ÿ $žüÏ& ɼ¡ ¥ ¡ üü*Tÿ € €É¼ €ô» Š
|
|||
|
|
¡ $�üÈ$ ɼ£ ¢ £ üó 4ö � �ɼ �“½ ¢ ý ¢
|
|||
|
|
£ $þü±' ɼ¥ ¥ ¥ üß+Tâ ‚ ‚ɼ ‚“½ ¤ í ¤
|
|||
|
|
¥ $òüq ¥ § ¦ ¨ £ © § © ¨ Âü ² µ€ µ Íì÷¾ ¸ ÐãLç ïíº <ù £÷¾ô» ¤‰«¾ª« $F $G « ]_ bd ^` L¥$ª ¦ ¦ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
íº ðíº ñüÑTLÔ ƒ „ …„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ƒ«¾ „Ì�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å …œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤Ãۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ«¾ $F ¦ è ¦
|
|||
|
|
«çºíº÷¾$ÞÈçôÔ´lÁ,¸@ «ÄŸ ÜŸ ùŸ « çºíº÷¾ ÕðÕð $¸E «ÄŸ ® ÜŸ ® ùŸ ® ® « ®çºíº÷¾�õ�õ,ÈL «ÄŸ ¯ ÜŸ ¯ ùŸ ¯ ¯ « ¯çºíº÷¾ ÞÌÞÌ �õüÅU™ ¥ ± š ² ¦ ³ ¨ ´ ² ± ³ ´ Âü ÊU ÍìÕ¿ ÍU ÍìË» ÐU ÍìÏ¿ ÓU ßñTƒV ú˻տ T–V é ˻տ üÞÌ |°V £Ï¿“½ ¬ÈVƒ¿µ¶·¸º
|
|||
|
|
· º ¸ ¶ ¸º ´¶ °² ¬® TåV,êV ° ° žøü�W^T„W † ‡ ˆ„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• †ƒ¿ ‡Ì�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ˆœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ƒ¿Õ¿ ° �W °
|
|||
|
|
¶çºÕ¿Ë»Ï¿$“WÈç©Wü¬YGT¯Y ‰„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ‰ƒ¿Õ¿þû ° ÄY °
|
|||
|
|
·çºÕ¿Ë»Ï¿$ºY÷$ÐYüš[ZT�[ Š ‹ Œ„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• Šƒ¿ ‹Ì�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å Œ¹û ° ²[ °
|
|||
|
|
¸çºÕ¿Ë»Ï¿$¨[Èç¾[܃\t�\üÇb^TÊb � Ž �„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• �ƒ¿ ŽÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å �¹û ° ãb °
|
|||
|
|
ºçºÕ¿Ë»Ï¿$ÙbÈçïbŒ¾d
|
|||
|
|
<
|
|||
|
|
<ü;ÿ;î;ñ;à;ã;T�e 4…eÒ´×ÛÌ3< ï À Á¹4<? ú À Âô™Th € À ĽQDt ¯ À ÅæPL~ ¨ À Æê5T‰ “ À Çʶ4© $E À Èú‰LÁ ’ À ʶŠTÌ Å À ËȸDå  À ̳ù$�
|
|||
|
|
À Íâ„\� À Î× ³ ¤, À Ï•RÁ ¦ À Ц‹ Ó „¾ À Ñk<è Ì� À Ó·$ñ œØ À Ôô hô( ZÌL KN=@/2!$¤› Lµ
|
|||
|
|
÷ù|Þ é”ó Ùì‹ ÊD® »<¼ ¬lÉ œLÜ ��{}¼—
|
|||
|
|
¥ Ö ¦ × Ö × Âü œ
|
|||
|
|
µ€ Ÿ
|
|||
|
|
¬ÀØÙÚÛÜÝÞßàãäåæçèéêë FH KM ü�. üµ
|
|||
|
|
P ”Î üŠQ N I/O object, using [`Decoder`] and [`Encoder`] to read and write the raw data.Á à ú üèK é— ü¸F ÞÏ üƒE B method layers framing on top of an I/O object, by using the codecÁ üÍH ÿÐ üš: ÑÑ Ù ú üáG D This function returns a *single* object that is both [`Stream`] andÁ üM J [`Sink`]; grouping this into a single object is often useful for layeringÁ üÿL ÅÓ ´Ð šÔ ë ú üóI ÆÔ üÁI F calling [`split`] on the `Framed` returned by this method, which willÁ ü�L ìÕ à ú üèL I Note that, for some byte sources, the stream can be resumed after an EOFÁ ü¹L I by reading from it, even after it has returned `None`. Repeated attemptsÁ üŠK H to do so, without new data available, continue to return `None` withoutÁ üÚ# creating more (closing) frames.Á ‚ ú üŠ$ ߃ ü³ �„ üØ% " [`Decode`]: crate::codec::DecoderÁ ü‚& # [`Encoder`]: crate::codec::EncoderÁ ü[ X [`split`]: https://docs.rs/futures/0.3/futures/stream/trait.StreamExt.html#method.splitÁ ” çºíº¬À Õ Õ
|
|||
|
|
Øçºíºð,˜ ÷1,¢ üØ&I üìP ”Î üÁ Q N I/O object, using [`Decoder`] and [`Encoder`] to read and write the raw data,Á ü— 1 . with a specific read buffer initial capacity.Á Í ú üÕ K é— ü¥ F ÞÏ üð E Òˆ üº H ÿÐ ü‡ : ÑÑ Æ ú üÎ G ɉ üš!M šŠ üì!L ÅÓ ´½" šÔ Ø" ú üà"I ÆÔ ü®#I ¦‹ üü#L ìÕ Í$ ú üÕ$$ ߃ üþ$ �„ ü£%% éŽ üÍ%& ˜� üø%[ È�lß& çºíº ¬À Õ Õ
|
|||
|
|
Ùçºíºð,í& ÷1,÷& ÷‡D�' ü¹8; ü“,P ”Î üè,Q χ ¾- ú üÆ-K é— ü–.F ÞÏ üá.G ®Ð ü/H ÿÐ üú/: ÑÑ ¹0 ú üÁ0G ɉ ü�1M šŠ üß1L ÅÓ ´°2 šÔ Ë2 ú üÓ2S P This objects takes a stream and a `readbuffer` and a `writebuffer`. These fieldÁ ü«3M J can be obtained from an existing `Framed` with the [`into_parts`] method.Á ý3 ú ü…4I ÆÔ üÓ4I ¦‹ ü¡5L ìÕ ò5 ú üú5$ ߃ ü£6 �„ üÈ6& # [`Decoder`]: crate::codec::DecoderÁ üó6& ˜� üž76 3 [`into_parts`]: crate::codec::Framed::into_parts()Á üÙ7[ È�TÀ8 ÀÁ¬À Õ Õ
|
|||
|
|
Úçºíº partsÁ,Ë8 ܾ= üª;? < Returns a reference to the underlying I/O stream wrapped byÁ lî;
|
|||
|
|
`Framed`.Á €< ú üˆ<K H Note that care should be taken to not tamper with the underlying streamÁ üØ<F C of data coming in as it may corrupt the stream of frames otherwiseÁ ´£= being worked with.Á<Å= � �¬À �çº Õ Í= Õ
|
|||
|
|
Ûçºíº$Î= ü�@# ü�>G D Returns a mutable reference to the underlying I/O stream wrapped byÁ lÍ> �› ß> ú üç>K À› ü·?F •œ ´‚@ äœ<¤@ ‘ ‘¬À ‘çº Õ ¬@ Õ
|
|||
|
|
Üçºíº$±@ ü�C7 üì@N K Returns a pinned mutable reference to the underlying I/O stream wrapped byÁ l¿A �› ÑA ú üÙAK À› ü©BF •œ ´ôB äœ\–C ’„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ’¬À„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ’çº Õ ¬C Õ
|
|||
|
|
Ýçºíº$¢C ÌõE ü�D: 7 Returns a reference to the underlying codec wrapped byÁ lÀD �› ÒD ú üÚDJ G Note that care should be taken to not tamper with the underlying codecÁ ü©EG D as it may corrupt the stream of frames otherwise being worked with.Á,üE “ “¬À “íº Õ ‚F Õ
|
|||
|
|
Þçºíº$ƒF ü²H% ü¶FB ? Returns a mutable reference to the underlying codec wrapped byÁ lýF �› �G ú ü—GJ ¬£ üæGG €¤L¹H ” ”¬À ”íº Õ ÃH Õ
|
|||
|
|
ßçºíº$ÈH üŒKY üƒID A Maps the codec `U` to `C`, preserving the read and write buffersÁ ÄÌI wrapped by `Framed`.Á éI ú üñIJ ¬£ üÀJG €¤L“K ¬À€ÿ × × ³— Úð À ßð$.ï}¤çº” Õ” á — â á â Õ Í쇪 �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¬k ` àB¤GS
|
|||
|
|
«“² ú i ú
|
|||
|
|
ýçºíº$¡i ± §i äðp ¥ ÿ ¦ € € ÿ Âü õp µ€ øp ÀÁ� üÀqT ü“q( % Create a new, default, `FramedParts`Á Çq çºíºÀÁ þš ‚ ‚ þ Íìš Ëq úíºšÌ T‰r
|
|||
|
|
�çºíºšÌ•RÎq ÷1,Õq 9; d•e�`„`u`x`|»e \¿eÒ®²ô™T € † ˆæPL, ¨ † ‰Ì3<J ï † Š öʶ4f $E † ‹ú‰L} ’ † ŒÈ¸D”  † �³ù$°
|
|||
|
|
† Žâ„\Ì † �× â ¤, † �¦‹ õ „¾ † ‘k<Š Ì� † “·$“ œØ † ”òQ\¦ ´ † • …Ì ¬< ¤X î¤r ß|� Д¢ Àìº ±DÝ ¢lë ’Lþ ƒ…qs”Ÿ cÜì ¥ — • ˜ — ˜ Âü ñ ÍìŸÃ ô 왚›œ�žŸ ¡¤¥¦§ @B <> üË 4 üŽ 8 5 Creates a new `FramedRead` with the given `decoder`.Á Ò çºŸÃì – –
|
|||
|
|
™çºŸÃð,Ö Ÿ3<à üª O ü½ R O Creates a new `FramedRead` with the given `decoder` and a buffer of `capacity`Á Œ” initial size.Ál± 纟à ì – –
|
|||
|
|
šçºŸÃð,¿ Ÿ3<É ÷‡DÕ Ü‰ üñ? Õš Œµ `FramedRead`.Á Ë ú üÓK À› ü£F •œ ´î äœ<� ¬ ¬ì ¬çº – ˜ –
|
|||
|
|
›çºŸÃ$™ üì# üÌG í� Œ˜ ŠÓ ® ú ü¶K À› ü†F •œ ´Ñ äœ<ó ìÂ çº – û –
|
|||
|
|
œçºŸÃ$€ üâ7 ü»N éŸ ŒŽ ŠÓ ¤ ú ü¬K À› üüF •œ ´Ç äœ\é ®„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ®ì„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ®çº – ÿ –
|
|||
|
|
�纟Ã$õ äÚ üÔC @ Consumes the `FramedRead`, returning its underlying I/O stream.Á œ ú ü¤K À› üôF •œ ´¿ äœTá ìÂçº – –
|
|||
|
|
žçºŸÃ$ì ÜÔ ü�2 / Returns a reference to the underlying decoder.Á<Û ¯ ¯ì ¯ŸÃ – ã –
|
|||
|
|
ŸçºŸÃ$ä üÖ ' ü— : 7 Returns a mutable reference to the underlying decoder.Á\Ý ° °ì °ŸÃ – é –
|
|||
|
|
纟Ã$î ü† _ ü© ; 8 Maps the decoder `D` to `C`, preserving the read bufferÁ Äé ñ§\� ì€ÿ ® ® î” ±ð † ŒˆÓÅ´˜áé纇ª –” ¢ — £ £ ¢ – ¼ª ™ ×€ œ –"€ÿŸÃ tÖ €ÿ£ß˜" ‡ª ã
|
|||
|
|
¡çºŸÃ‡ª€ÿ$Ÿ Ø ¥ ]_ bd ü•"6 üÖ!: ŠÛ|œ" ±„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ±ì ±ŸÃ – ¶" –
|
|||
|
|
¤çºŸÃ$¬" ü¶#& ü†#+ ¬\½# ² ²ì ²¾¹ – É# –
|
|||
|
|
¥çºŸÃ$Ê# üÃ$2 ü‹$3 Ë|Ê$ ³ ³ì ³¾¹ – Ú$ –
|
|||
|
|
¦çºŸÃ$ß$ ü©&, ü¨%N K Consumes the `FramedRead`, returning its underlying I/O stream, the bufferÁ üû%) øµT°& ì ´ ´ òQ ·•R ¸÷1 ¹§R º·R »»E Ö"#òEVµçºŸÃ – –
|
|||
|
|
§çºŸÃ$»& üì(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¬k ` àB¤GS
|
|||
|
|
Ó² ¶ ï1 ¶
|
|||
|
|
¹çºŸÃ$ð1 ± ö1 ìÔe'v„ôe døeÒ…‰¹4< ú » ¼ô™TD € » ¾ê5TP “ » ¿Ê¶4p $E » À¶ŠT‡ Å » ÁȸDŸ  » ³ù$»
|
|||
|
|
» Ãâ„\× » Ä× í ¤, » Å•Rû ¦ » Ʀ‹ � „¾ » Çk<¢ Ì� » É·$« œØ » ÊòQ\¾ ´ » Ë …ô -Ì( !¤b ¬| ö|˜ æ” ÖìÅ ÇDè ¸<ö ©lƒ ™L– ŠŒxz”· jä» ¥ Í – Î Î Í Âü À Íì�Å Ã ÎÄÏÐÑÒÓÔÕÖ×ÚÛÜÝÞß FH BD üœ 5 üÞ9 6 Creates a new `FramedWrite` with the given `encoder`.Á £ çº�ÅÎÄ Ì Ì
|
|||
|
|
Ïçº�Åð,§ 4<± ü� P ü“ S P Creates a new `FramedWrite` with the given `encoder` and a buffer of `capacity`Á Œë €Òlˆ çº�Å ÎÄ Ì Ì
|
|||
|
|
Ðçº�Åð,– 4< ÷‡D¬ Ü© ü�? Õš ”Ô `FramedWrite`.Á ë ú üóK À› üÃF •œ ´Ž äœ<° Ä ÄÎÄ Äçº Ì ¸ Ì
|
|||
|
|
Ñçº�Å$¹ ü�# üìG í� ”¸ àþ Ï ú ü×K À› ü§F •œ ´ò äœ<” Å ÅÎÄ Åçº Ì œ Ì
|
|||
|
|
Òçº�Å$¡ ü„7 üÜN éŸ ”¯ àþ Æ ú üÎK À› üžF •œ ´é äœ\‹ Æ„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ÆÎÄ„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• Æçº Ì ¡ Ì
|
|||
|
|
Óçº�Å$— äý üöD A Consumes the `FramedWrite`, returning its underlying I/O stream.Á ¿ ú üÇK À› ü—F •œ ´â äœT„ ÎÄçº Ì Ì
|
|||
|
|
Ôçº�Å$� Ü÷ üÀ2 / Returns a reference to the underlying encoder.Á<þ Ç ÇÎÄ Ç�Å Ì † Ì
|
|||
|
|
Õçº�Å$‡ üù' üº: 7 Returns a mutable reference to the underlying encoder.Á\€ È ÈÎÄ È�Å Ì Œ Ì
|
|||
|
|
Öçº�Å$‘ üª ` üÌ < 9 Maps the encoder `E` to `C`, preserving the write bufferÁ Ä� ñ§\± ÎÄ€ÿ … … ¨’ ˆð » ¤…ÉŠª|9Ù纇ª Ì” Ø — Ù Ù Ø Ì ¼ª ½ ×€ À –"€ÿ�Å tû €ÿüŠ ˜" ‡ª ˆ
|
|||
|
|
×çº�Ňª€ÿ$Ã Ø É ]_ bd ü»!6 üü : ↠|Â! É„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• ÉÎÄ É�Å Ì Ü! Ì
|
|||
|
|
Úçº�Å$Ò! üÝ"' ü¬", ñ®dä" Ê ÊÎÄ Ê¾¹ Ì ñ" Ì
|
|||
|
|
Ûçº�Å$ò" üì#3 ü³#4 �°„ó# Ë ËÎÄ Ë¾¹ Ì „$ Ì
|
|||
|
|
Üçº�Å$‰$ üø$, üÒ$! ·±¬ÿ$ Ì ÌÎÄ Ì •% Ì
|
|||
|
|
Ýçº�Å$–% ü‡&< üá%! À²ÌŽ& Í ÍÎÄ Ì ¨& Ì
|
|||
|
|
Þçº�Å$& ½³D³& üŽ(, üŒ'O L Consumes the `FramedWrite`, returning its underlying I/O stream, the bufferÁ üà') øµT•( ÎÄ ´ ´ òQ ·•R ¸÷1 ¹§R º·R »»E Ö"#òEVµçº�Å Ì Ì
|
|||
|
|
ßçº�Å$ ( üÑ*v ¥ á š â – ã á â ã Âü Ö* È÷ Ù* Íì¶Ä Ü* ßñTŠ+ ú¶ÄÕ¿ T�+ é ¶ÄÕ¿ üÞÌ |·+ �Åäåæçè
|
|||
|
|
è æ ç å ŠŒ �‘ ‹� TÎ+ ,Ó+ à à Þ“ üê+Z Tí+ Î Ï Ð„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• Î�Å ÏÌ�Ì� k Î�ü¸� Ï�Š�¸� Ð�£�¸� Ñ�´�¸� Ò�É�¸� f'EwÚ]¾å ÐœØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
�ÅÕ¿ à ‚, à
|
|||
|
|
åçºÕ¿¶Ä$ø+ ÈçŽ, üþ,G T�- Ñ„¾„¾ ¦‹ †¾‰ ˜X $ ]È=„kt• Ñ�ÅÕ¿œ— à –- à
|
|||
|
|
æçºÕ¿¶Ä$Œ- ÷$¢-
|
|||
|
|
` £c¬k ` à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ú ü«b0„ Übú \àbŸ° üìb8 5 INPUT DECODEDÁ ü¥c= : +------- len ------+--- Payload ---+ +--- Payload ---+Á üãc= : | \x00\x00\x0B\xFF | Hello world | => | Hello world |Á ü¡d= : +------------------+---------------+ +---------------+Á <ßd�¯ çdú üëdJ G A simple example where there are unused bytes between the length fieldÁ ¤¶e and the payload.Á Ëeú tÏe # EncodingÁ Þeú üâeK H [`FramedWrite`] adapts an [`AsyncWrite`] into a `Sink` of [`BytesMut`],Á ü®fH E such that each submitted [`BytesMut`] is prefaced by a length field.Á ü÷fD A There are fewer configuration options than [`FramedRead`]. GivenÁ ü¼gL I protocols
|
|||
|
|
# let _ =Á ü¬j# LengthDelimitedCodec::builder()Á üÐj#ß¿ ¼ôj .new_write(io);Á <Œköß ´”kœ® <«k�¯ ³kú ü·k2 / A payload of `hello world` will be encoded as:Á êkú \îkŸ° üúk! +- len: u16 -+---- data ----+Á üœl! | \x00\x0b | hello world |Á ü¾l! +------------+--------------+Á <àl�¯ èlú üìlE B [`LengthDelimitedCodec::new()`]: method@LengthDelimitedCodec::newÁ ü²m% " [`FramedRead`]: struct@FramedReadÁ üØm' $ [`FramedWrite`]: struct@FramedWriteÁ ü€n- * [`AsyncRead`]: trait@tokio::io::AsyncReadÁ ü®n/ , [`AsyncWrite`]: trait@tokio::io::AsyncWriteÁ ôÞn [`Encoder`]: trait@EncoderÁ üýn! [`BytesMut`]: bytes::BytesMutÁ „¸f Š�ÀÍÔÌ3<³o ï ó õ ö¹4<¼o ú ó ö þ³—4Åo × ó ÷ „î”TÍo ® ó ø º¨’\Ùo … ó ù òú‰Løo ’ ó û¶ŠTƒp Å ó üÚÓ �p ó þðÓ4¢p ™ ó ÿÜ·,ªp à ó €È¸D±p  ó � StdErrorÁDÕp ¾ ó ‚•R$íp ¦ ó „ CursorÁ4óp öJ ó …‹ †q ‹ ó ‡× ‹q ¤, ó ˆí �q ë ó ‰d¤o�“}€ilUXADLìo14!$,•p öøäæŒÀpÏ<ãpÀèp« €qž ��|~üÁz$ ü÷yI F An error when the number of bytes read is more than max frame length.Á ÌÌz ôÉ ¼Ú„f˜IÉ ‹Lìz,ìzó Š Š ̶ ÜÇ�Ž��‘’ ¤ª€ üÖO L Creates a new `LengthDelimitedCodec` with the default configuration values.Á ±€ ÜÇ Œ Œ
|
|||
|
|
� Ü�‚ ü°�K H Creates a new length delimited codec builder with default configurationÁ \€‚ values.Á<—‚ ÊÆ Œ Œ
|
|||
|
|
Ž üõƒ' üЂ) & Returns the current max frame settingÁ þ‚ú ü†ƒI F This is the largest size this codec will accept from the wire. LargerÁ äÔƒ frames will be rejected.Á„üƒ Þ ÞÜÇ Œ �„ Œ
|
|||
|
|
� $Ž„üª‡2 üÍ„" Updates the max frame setting.Á ô„ú üü„F C The change takes effect the next time a frame is decoded. In otherÁ üÇ…K H words, if a frame is currently in process of being decoded with a frameÁ ü—†H E size greater than `val` but less than the max frame length in effectÁ üä†A > before calling this function, then the frame will be allowed.Á¤±‡ ß ßÜÇ Œ Ƈ Œ
|
|||
|
|
� $ˇ¹ чü–ˆJ\™ˆ ó à á àÜÇ á¾¹Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
’ÒÞÌ Œ ¥ˆ Œ
|
|||
|
|
‘ $ªˆöà °ˆüè–G\ë– ó â ã âÜÇ ã¾¹É‘ Œ ÷– Œ
|
|||
|
|
’ $ø–¹ þ–öà ˆ—ü”™% ÜÇ”•– ð ñ ò – LÀ™$Å™ “ “ ¾¹TÚ™,ß™ “ “ ÞÌü÷™H4ú™ ä å äÜÇ å¾¹û� “ �š “
|
|||
|
|
– $†šöà Œšü± , Üǘ™ ü ý ™ Tä ,é — — ÞÌü�¡N4„¡ æ ç æÜÇÒ¸ ç¾¹Þ› — ‹¡ —
|
|||
|
|
™ $�¡‚¸$–¡ˆâ £¡ç¥ ™ ÄŸ š ÜŸ š ùŸ š š ™ š ÞÌ ü‰«% ÜÇœ ´ œ ¤µ«<¸« ÜÇ › ›
|
|||
|
|
œ \†¬ <Š¬óžÌÚ¬ |ä¬ ž ž úƒäÚ¬ ž úƒ úƒ Üü¬ äŸ äà äç ô’¯ û 16ÁÜŸ®û 32ÁÜÄ®û 64ÁÜé®ü•®vüŒ®� d·¯ ÊÆ¥¦§¨©ª¬®¯°±³µ·¸¹ ¼å³ üʯK›˜
|
|||
|
|
\š°ð˜
|
|||
|
|
ª°ú t²°¥¦ Å°ú <Í°�¯ üÙ° # use tokio::io::AsyncRead;Á üý°0 - use tokio_util::codec::LengthDelimitedCodec;Á ²±ú üº±) & # fn bind_read<T: AsyncRead>(io: T) {Á üè±#È‹
|
|||
|
|
ü�² .length_field_offset(0)Á ü´²#ß¿ ìܲ .length_adjustment(0)Á ¤þ²íÝ ´—³ÅÀ <²³öß ´¾³œ® <Ù³�¯ ì³ ÊÆ ¤ ¤
|
|||
|
|
¥ ü‰½) ü‡¹1 . Read the length field as a big endian integerÁ ½¹ú üŹ This is the default setting.Á ê¹ú üò¹D A This configuration option applies to both encoding and decoding.Á »ºú tú¥¦ Öºú <Þº�¯ üêº ç©
|
|||
|
|
üŽ»0‘ª
|
|||
|
|
ûú üË»)Ùª
|
|||
|
|
üù»#È‹
|
|||
|
|
¬¡¼ .big_endian()Á ´»¼ÅÀ <Ö¼öß ´â¼œ® <ý¼�¯T�½ è èÊƶ±
|
|||
|
|
¤ ›½ ¤
|
|||
|
|
¦ $ ½ü‹Â, üý½4 1 Read the length field as a little endian integerÁ ¶¾ú ü¾¾& # The default setting is big endian.Á é¾ú üñ¾Dý
|
|||
|
|
º¿ú t¿¥¦ Õ¿ú <Ý¿�¯ üé¿ ç©
|
|||
|
|
ü�À0‘ª
|
|||
|
|
ÂÀú üÊÀ)Ùª
|
|||
|
|
üøÀ#È‹
|
|||
|
|
Ä Á .little_endian()Á ´½ÁÅÀ <ØÁöß ´äÁœ® <ÿÁ�¯l’ é éÊÆ�µ
|
|||
|
|
¤ Â ¤
|
|||
|
|
§ $¥Âü‘Ç, üƒÃ4 1 Read the length field as a native endian integerÁ ¼Ãú üÄÃ&DZ
|
|||
|
|
ïÃú ü÷ÃDý
|
|||
|
|
ÀÄú tÈÄ¥¦ ÛÄú <ãÄ�¯ üïÄ ç©
|
|||
|
|
ü“Å0‘ª
|
|||
|
|
ÈÅú üÐÅ)Ùª
|
|||
|
|
üþÅ#È‹
|
|||
|
|
Ä¦Æ .native_endian()Á ´ÃÆÅÀ <ÞÆöß ´êÆœ® <…Ç�¯l˜Ç ê êÊƪ¸
|
|||
|
|
¤ ¦Ç ¤
|
|||
|
|
¨ $«ÇüçÏ; üÎÈ& # Sets the max frame length in bytesÁ ùÈú ü�ÉH E This configuration option applies to both encoding and decoding. TheÁ ÌÎÉ default value is 8MB.Á ìÉú üôÉH E When decoding, the length field read from the byte stream is checkedÁ üÁÊE B against this setting **before** any adjustments are applied. WhenÁ ü‹ËI F encoding, the length of the submitted payload is checked against thisÁ dÙË setting.Á êËú üòËK H When frames exceed the max length, an `io::Error` with the custom valueÁ üÂÌ= : of the `LengthDelimitedCodecError` type will be returned.Á „Íú tŒÍ¥¦ ŸÍú <§Í�¯ ü³Í ç©
|
|||
|
|
ü×Í0‘ª
|
|||
|
|
ŒÎú ü”Î)Ùª
|
|||
|
|
üÂÎ#È‹
|
|||
|
|
üêÎ* ' .max_frame_length(8 * 1024 * 1024)Á ´™ÏÅÀ <´Ïöß ´ÀÏœ® <ÛÏ�¯„îÏ ë ëÊÆ è¿
|
|||
|
|
¤ ÿÏ ¤
|
|||
|
|
© $„й ŠÐüÂØM üßÐF C Sets the unsigned integer type used to represent the length field.Á ªÑú ü²ÑI F The default type is [`u32`]. The max type is [`u64`] (or [`usize`] onÁ ¤€Ò 64-bit targets).Á ™Òú t¡Ò¥¦ ´Òú <¼Ò�¯ üÈÒ ç©
|
|||
|
|
üìÒ0‘ª
|
|||
|
|
¡Óú ü©Ó)Ùª
|
|||
|
|
ü×Ó#È‹
|
|||
|
|
üÿÓ# .length_field_type::<u32>()Á ´§ÔÅÀ <ÂÔöß ´ÎÔœ® <éÔ�¯ õÔú üýÔJ G Unlike [`Builder::length_field_length`], this does not fail at runtimeÁ üÌÕ) & and instead produces a compile error:Á úÕú œ‚Ö ```compile_failÁ üšÖ ç©
|
|||
|
|
ü¾Ö2Ù½ üõÖ)Ùª
|
|||
|
|
ü£×#È‹
|
|||
|
|
üË×$ ! .length_field_type::<u128>()Á ´ô×ÅÀ <�Øöß ´›Øœ® <¶Ø�¯ŒÉØ ì ìÊÆåÆ
|
|||
|
|
¤ ¥ « « øØ ¤ Âü ÛØ žçº ÄÞØ
|
|||
|
|
ªçº$ýØ') ü€Þ> üÓÙ? < Sets the number of bytes used to represent the length fieldÁ —Úú üŸÚ3 0 The default value is `4`. The max value is `8`.Á ×Úú üßÚDý
|
|||
|
|
¨Ûú t°Û¥¦ ÃÛú <ËÛ�¯ ü×Û ç©
|
|||
|
|
üûÛ0‘ª
|
|||
|
|
°Üú ü¸Ü)Ùª
|
|||
|
|
üæÜ#È‹
|
|||
|
|
üŽÝ .length_field_length(4)Á ´²ÝÅÀ <ÍÝöß ´ÙÝœ® <ôÝ�¯œ‡Þ í íÊÆ ŠË
|
|||
|
|
¤ ›Þ ¤
|
|||
|
|
¬ $ Þ¹ ¦Þü¦ã> üÃßB ? Sets the number of bytes in the header before the length fieldÁ Šàú ü’à7 4 This configuration option only applies to decoding.Á Îàú tÖ० éàú <ñà�¯ üýà ç©
|
|||
|
|
ü¡á0‘ª
|
|||
|
|
Öáú üÞá)Ùª
|
|||
|
|
üŒâ#È‹
|
|||
|
|
ü´â .length_field_offset(1)Á ´ØâÅÀ <óâöß ´ÿ✮ <šã�¯œã î îÊÆ ëÎ
|
|||
|
|
¤ Áã ¤
|
|||
|
|
$Æã¹ Ìãüãç< ü§äI F Delta between the payload length specified in the header and the realÁ ”õä payload lengthÁ Œåú t”奦 §åú <¯å�¯ ü»å ç©
|
|||
|
|
üßå0‘ª
|
|||
|
|
”æú üœæ)Ùª
|
|||
|
|
üÊæ#È‹
|
|||
|
|
ôòæ .length_adjustment(-2)Á ´•çÅÀ <°çöß ´¼çœ® <×ç�¯Œêç ï ïÊÆ žÒ
|
|||
|
|
¤ üç ¤
|
|||
|
|
® $�è¹ ‡èüþì3 üàè? < Sets the number of bytes to skip before reading the payloadÁ ¤éú ü¬é= : Default value is `length_field_len + length_field_offset`Á îéú üöé6 3 This configuration option only applies to decodingÁ ±êú t¹ê¥¦ Ìêú <Ôê�¯ üàê ç©
|
|||
|
|
ü„ë0‘ª
|
|||
|
|
¹ëú üÁë)Ùª
|
|||
|
|
üïë#È‹
|
|||
|
|
¤—ì .num_skip(4)Á ´°ìÅÀ <Ëìöß ´×윮 <òì�¯D…í ð ðÊÆ ÄÖ
|
|||
|
|
¤ Ží ¤
|
|||
|
|
¯ $“í¹ ™íü’ñ/ üïí? < Create a configured length delimited `LengthDelimitedCodec`Á ³îú t»î¥¦ Îîú <Öî�¯ üâî0‘ª
|
|||
|
|
¬—ï # pub fn main() {Á ü±ï#È‹
|
|||
|
|
üÙï œ«
|
|||
|
|
üýï#ß¿ ì¥ðÔ«
|
|||
|
|
¤ÇðíÝ ¬àð .new_codec();Á <úðöß <†ñ�¯L™ñ ñ ñÊÆ ÜÇ ¤ £ñ ¤
|
|||
|
|
° $¤ñüóöm üþò5 2 Create a configured length delimited `FramedRead`Á ¸óú tÀó¥¦ Óóú <Ûó�¯ üçó ç©
|
|||
|
|
ü‹ô0‘ª
|
|||
|
|
Àôú üÈô)Ùª
|
|||
|
|
üöô#È‹
|
|||
|
|
üžõ œ«
|
|||
|
|
üÂõ#ß¿ ìêõÔ«
|
|||
|
|
¤ŒöíÝ ´¥öÅÀ <Àööß ´Ìöœ® <çö�¯Dúö ò òÊÆ çº ® ® î” ±ð † ŒˆÓÅ´˜áéçºÜÇ ¤ ¥ ² ² †÷ ¤ Âü ƒ÷ ÐãLÖ÷
|
|||
|
|
±çº$‡÷ upstreamÁD�÷02 ü¼ûm ü¦ø6 3 Create a configured length delimited `FramedWrite`Á áøú téø¥¦ üøú <„ù�¯ ü�ù ÄŠ
|
|||
|
|
üµù2Ù½ üìù,üŠ
|
|||
|
|
ü�ú#È‹
|
|||
|
|
üÅú#ß¿ ¼íú‚Œ
|
|||
|
|
<‰ûöß ´•ûœ® <°û�¯LÃû ó óÊÆ çº … … ¨’ ˆð » ¤…ÉŠª|9ÙçºÜÇ ¤ ¥ ´ ´ Ðû ¤ Âü Íû ßñTžü
|
|||
|
|
³çº$Ñûð,×û(* üª€u üíü1 . Create a configured length delimited `Framed`Á £ýú t«ý¥¦ ¾ýú <Æý�¯ üÒý- * # use tokio::io::{AsyncRead, AsyncWrite};Á ü„þ2Ù½ ü»þ8 5 # fn write_frame<T: AsyncRead + AsyncWrite>(io: T) {Á løþ±‹
|
|||
|
|
üŠÿ#È‹
|
|||
|
|
ü²ÿ#ß¿ ÄÚÿ .new_framed(io);Á <÷ÿöß ´ƒ€œ® <ž€�¯T±€ ô ôÊÆ çº × × ³— Úð À ßð$.ï}¤çºÜÇ ¤ ¥ ¶ ¶ ¿€ ¤ Âü ¼€ ÐãLˆ� ßñT”�
|
|||
|
|
µçº$À€ð,Æ€13 üÞ�!tá� ó õ õÊÆ ¤ ð� ¤
|
|||
|
|
· $ñ�üƒƒ d†ƒ ó ö öÊÆ ¤ “ƒ ¤
|
|||
|
|
¸ $”ƒü�„"¤’„ ó ÷ ÷ÊÆ ¤ §„ ¤
|
|||
|
|
¹ $¬„Ä»ˆ ÊÆ» ´ » ¤Úˆ<݈ ÊÆ º º
|
|||
|
|
» ü½‰- ôɽ Àc ½ üñ‰8 ô‰ ø ù ú øôÉ ù c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
ú“² ¼ ø‰ ¼
|
|||
|
|
½ $ù‰± ÿ‰üòŠ/ ôÉ¿ Åc ¿ ü¨‹8 «‹ û ü ý ûôÉ ü c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
ý“² ¾ ¯‹ ¾
|
|||
|
|
¿ $°‹± ¶‹ü–Œ+ ôÉ ´Òfðð
|
|||
|
|
ð
|
|||
|
|
ð|žg \¢gÒÔÖàôÌ3< ï Ä Å¹4<? ú Ä ÆÚÓ U Ä ÈðÓ4Z ™ Ä ÉȸDb Â Ä Ê‹ w ‹ Ä Ì× | ¤, Ä Í•R� ¦ Ä ÎÉ … ™3 Ä Ïô¸ô(©,M™›‰‹xz qkm[]KM:<|æ ¿ÊÑÒÓ Ô˜ üü< 9 Returns a `LinesCodec` for splitting up data into lines.Á ½ ú TÅ # NoteÁ Ô ú üÜ H E The returned `LinesCodec` will not have an upper bound on the lengthÁ ü©
|
|||
|
|
I F of a buffered line. See the documentation for [`new_with_max_length`]Á ü÷
|
|||
|
|
C @ for information on why this could be a potential security risk.Á ¿ ú üÇ L I [`new_with_max_length`]: crate::codec::LinesCodec::new_with_max_length()Á Ÿ ¿Ê Ð Ð
|
|||
|
|
Ñ ü†5 üÀ
|
|||
|
|
< 9 Returns a `LinesCodec` with a maximum line length limit.Á �ú ü‰? < If this is set, calls to `LinesCodec::decode` will return aÁ üÍN K [`LinesCodecError`] when a line exceeds the length limit. Subsequent callsÁ ü C @ will discard up to `limit` bytes from that line until a newlineÁ üèH E character is reached, returning `None` until the line over the limitÁ üµF C has been fully discarded. After that point, calls to `decode` willÁ ¼€ function as normal.Á œú T¤Éî
|
|||
|
|
³ú ü»K H Setting a length limit is highly recommended for any `LinesCodec` whichÁ ü‹I F will be exposed to untrusted input. Otherwise, the size of the bufferÁ üÙL I that holds the line currently being read is unbounded. An attacker couldÁ üªI F exploit this unbounded buffer by sending an unbounded amount of inputÁ üøF C without any `\n` characters, causing unbounded memory consumption.Á Ãú üË6 3 [`LinesCodecError`]: crate::codec::LinesCodecErrorÁœ� ¿Ê Ð Ð
|
|||
|
|
Ò ØKT¡üÏ! ü 2 / Returns the maximum line length when decoding.Á ×ú <ß�¯ œë use std::usize;Á üƒ&Ïž ®ú ü¶" let codec = LinesCodec::new();Á üÝ/ , assert_eq!(codec.max_length(), usize::MAX);Á <‘�¯ <��¯ ü©&Ïž Ôú üÜ5 2 let codec = LinesCodec::new_with_max_length(256);Á ü–( % assert_eq!(codec.max_length(), 256);Á <Ã�¯TÖ þ þ¿Ê Ð á Ð
|
|||
|
|
Ó $âü”.$— Ä ÿ ÿƒÑ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÿ ÞÌ ¡
|
|||
|
|
Ô ¬k œ î Ô ÄŸ Õ ÜŸ Õ ùŸ Õ Õ Ô Õ ÅÏÅÏ Utf8ErrorÁ ÆÏ valid_up_toÁ¯v ÇÏ error_lenÁ¯v lÅooÛÜ è ÞÌ üÃ-¼Æ Ä € €ƒÑ Á‚ á
|
|||
|
|
Ö ¾ ÞÜÒ ¿ÊØÙÚÛ ð ñ ò ó Û Ú Lô $ù × × úHúH ß ûHÁ‘4 Ýf‰úM÷ TŒ ,‘ × × ‰Ìü¯ S4² � ‚ �¿Ê ‚¾¹Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙºƒ ‰Ì × ¹ ×
|
|||
|
|
Ú $¾ ¬k Ä üË1WTÎ1 ƒ „ ƒ¿Ê „¾¹Ä„ × Ù1 ×
|
|||
|
|
Û $Þ1¬k ä1üä6: ¥ Ý Ý Âü é6 à çº T“7¿ÊÞß ü ý ß ,. T¥7,ª7 Ü Ü ‰ÌüÈ7P4Ë7 … † …¿Êçº †¾¹Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
‰Ì Ü Ò7 Ü
|
|||
|
|
ßçº$×7š$Ý7¬k æ7Ü·9 ¿Êá ´ á ¤Ù9<Ü9 ¿Ê à à
|
|||
|
|
á üï;% ‰Ìã Åc ã ü›<8 ž< ‡ ˆ ‰ ‡‰Ì ˆ c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
‰“² â ¢< â
|
|||
|
|
ã $£<± ©<ü“>( ‰Ìå ë å üÂ>($Å> ÞÌ‰Ì ä ä
|
|||
|
|
å ° Ê>ü•?* ‰Ì Œ·g ÷ÿúÿ¼êg œîgÒ÷øü’Ì3< ï ê ë¹4<? ú ê ìÚÓ U ê îðÓ4Z ™ ê ïÜ·,b à ê ðȸDi  ê ñ‹ ~ ‹ ê ó× ƒ ¤, ê ô•Rˆ ¦ ê õÉ Œ ™3 ê öô Îô( ¿,M ¯±Ÿ¡Ž�} x pr`bOQ>@ü“$ ¼™ ê ƒÑ üÅ$ ¼Ë ê �� ´… žÍúûü üÕS ü¢D A Returns a `AnyDelimiterCodec` for splitting up data into chunks.Á ë ú Tó Éî
|
|||
|
|
‚ ú üŠO L The returned `AnyDelimiterCodec` will not have an upper bound on the lengthÁ üÞJ G of a buffered chunk. See the documentation for [`new_with_max_length`]Á üC Žð
|
|||
|
|
õ ú üýS P [`new_with_max_length`]: crate::codec::AnyDelimiterCodec::new_with_max_length()Á Ü ªBªB ö B¬k÷< ®B‘÷< 9)
|
|||
|
|
-ÜnLוû’ žÍ ù ù
|
|||
|
|
ú åW|à üW|ú ü÷ ˆ ü÷D A Returns a `AnyDelimiterCodec` with a maximum chunk length limit.Á À ú üÈF C If this is set, calls to `AnyDelimiterCodec::decode` will return aÁ ü“V S [`AnyDelimiterCodecError`] when a chunk exceeds the length limit. Subsequent callsÁ üîF C will discard up to `limit` bytes from that chunk until a delimiterÁ ü¹M J character is reached, returning `None` until the delimiter over the limitÁ ü‹F ‡õ
|
|||
|
|
¼Ö Öõ
|
|||
|
|
ò ú Tú Éî
|
|||
|
|
‰ ú ü‘ R O Setting a length limit is highly recommended for any `AnyDelimiterCodec` whichÁ üè I ñö
|
|||
|
|
ü¶ M J that holds the chunk currently being read is unbounded. An attacker couldÁ üˆ I šø
|
|||
|
|
üÖ K H without any delimiter characters, causing unbounded memory consumption.Á ¦ ú ü® D A [`AnyDelimiterCodecError`]: crate::codec::AnyDelimiterCodecErrorÁœþ û’ û’ žÍ ù ù
|
|||
|
|
û åW|› üW|½ ØKTß üž&! ü’"3 0 Returns the maximum chunk length when decoding.Á Ê" ú <Ò" �¯ œÞ" Ÿû
|
|||
|
|
üö"- * use tokio_util::codec::AnyDelimiterCodec;Á ¨# ú ü°#H E let codec = AnyDelimiterCodec::new(b",;\n".to_vec(), b";".to_vec());Á üý#/ ‚ü
|
|||
|
|
<±$ �¯ <½$ �¯ üÉ$- ¢› û$ ú üƒ%] Z let codec = AnyDelimiterCodec::new_with_max_length(b",;\n".to_vec(), b";".to_vec(), 256);Á üå%( ®ý
|
|||
|
|
<’& �¯T¥& Š ŠžÍ ù °& ù
|
|||
|
|
ü $±& üã&" žÍþÿ€‚ ð ñ ò ó ‚ € LŒ' $‘' ý ý Ò¸T£' ,¨' ý ý €ÏüÍ'Y 4Ð' ‹ Œ ‹žÍ Œ¾¹Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÒ¸€Ï ý ×' ý
|
|||
|
|
€ $Ü' ¬k â' Ÿ+ € ÄŸ � ÜŸ � ùŸ � � € � û’ üü;] Tÿ; � Ž �žÍ Ž¾¹í ý Š< ý
|
|||
|
|
‚ $�< ¬k •< ü…@A ¥ „ „ Âü Š@ �‡ T»@ žÍ…† ü ý † "$ TÍ@ ,Ò@ ƒ ƒ €Ïü÷@X 4ú@ � � �žÍçº �¾¹Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
€Ï ƒ �A ƒ
|
|||
|
|
†çº$†A äg,ŒA ¬k –A ü¡C" žÍˆ ´ ˆ ¤ÊC <ÍC žÍ ‡ ‡
|
|||
|
|
ˆ üÏF, €ÏŠ Åc Š ü‚G8 …G ‘ ’ “ ‘€Ï ’ c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
““² ‰ ‰G ‰
|
|||
|
|
Š $ŠG ± �G ü©I/ €ÏŒ ë Œ üßI/ $âI ÞÌ€Ï ‹ ‹
|
|||
|
|
Œ ° çI üÀJ1 €Ï Ì‹h j n ` d ° ü}U
|
|||
|
|
R A simple [`Decoder`] and [`Encoder`] implementation that just ships bytes around.Á Ó
|
|||
|
|
ú ü×&
|
|||
|
|
ø˜ üþ&
|
|||
|
|
˜� ¥
|
|||
|
|
ú l©
|
|||
|
|
ðÖ ·
|
|||
|
|
ú ü»Q
|
|||
|
|
N Turn an [`AsyncRead`] into a stream of `Result<`[`BytesMut`]`, `[`Error`]`>`.Á �
|
|||
|
|
ú ü‘'
|
|||
|
|
ƒ ü¹!
|
|||
|
|
‹‘
|
|||
|
|
ìÛ
|
|||
|
|
[`Error`]: std::io::ErrorÁ ù
|
|||
|
|
ú <ý
|
|||
|
|
�¯ ”…
|
|||
|
|
# mod hidden {Á ô˜
|
|||
|
|
# #[allow(unused_imports)]Á Ä·
|
|||
|
|
Âç <Ð
|
|||
|
|
öß ìØ
|
|||
|
|
use tokio::io::AsyncRead;Á üö4
|
|||
|
|
1 use tokio_util::codec::{FramedRead, BytesCodec};Á «
|
|||
|
|
ú ”¯
|
|||
|
|
# enum File {}Á ŒÂ
|
|||
|
|
# impl File {Á üÔP
|
|||
|
|
M # async fn open(_name: &str) -> Result<impl AsyncRead, std::io::Error> {Á ü¥"
|
|||
|
|
# use std::io::Cursor;Á üÈ5
|
|||
|
|
2 # Ok(Cursor::new(vec![0, 1, 2, 3, 4, 5]))Á \þ
|
|||
|
|
# }Á <Š
|
|||
|
|
öß ,’
|
|||
|
|
¡º ü˜/
|
|||
|
|
œÙ üÈ5
|
|||
|
|
2 # async fn main() -> Result<(), std::io::Error> {Á üþ:
|
|||
|
|
7 let my_async_read = File::open("filename.txt").await?;Á ü¹O
|
|||
|
|
L let my_stream_of_bytes = FramedRead::new(my_async_read, BytesCodec::new());Á d‰
|
|||
|
|
áß <–
|
|||
|
|
öß <ž
|
|||
|
|
�¯ ¦
|
|||
|
|
ú 7T‚
|
|||
|
|
|
|||
|
|
‘· ¹ÞÍÁ•î0 ’ “ ‘· °6 Ó ‘· ‘ ‘
|
|||
|
|
’ �
|
|||
|
|
|
|||
|
|
Ó ‘ ‘ ³
|
|||
|
|
Y ‘· (
|
|||
|
|
¹
|
|||
|
|
|
|||
|
|
Z ‘· 0 4 Z ‘·— Ù — OQ ” ”‘· ‘· –
|
|||
|
|
¹
|
|||
|
|
–
|
|||
|
|
— œ(À
|
|||
|
|
[ ‘·™ Àc ™ "$ • – — •‘· – c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
—“² ˜ À
|
|||
|
|
˜
|
|||
|
|
™ űËÇ
|
|||
|
|
\ ‘·› › › " ( = ˜ ˜‘· š Ç
|
|||
|
|
š
|
|||
|
|
› ‡HË
|
|||
|
|
] ‘· ] ‘·ž ·ß ž 79 ™ š ™‘· š‘· � Ë
|
|||
|
|
�
|
|||
|
|
ž ”¹
|
|||
|
|
šÖ
|
|||
|
|
^ ‘· » "$ › œ ›‘· œ‘· ¿ßÀßÁß LessÁ Âß ÃßÄß~ Åß ÆßÇß GreaterÁ Èß åºÝÈnûê7 Ÿ Ö
|
|||
|
|
Ÿ
|
|||
|
|
à¹
|
|||
|
|
æPÛ
|
|||
|
|
_ ‘·¢ ïß ¢ #% � ž �‘· ž‘· ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ…º ¡ Û
|
|||
|
|
¡
|
|||
|
|
¢ ǹ
|
|||
|
|
Í ç
|
|||
|
|
` ‘·¤ ›e ¤ "$ Ÿ Ÿ‘· ù £ ù ¥ ¥ ç
|
|||
|
|
£ Íì¹½ — ¢e¹½ ¥
|
|||
|
|
¤¹½ ³º¹»½ 8í
|
|||
|
|
a ‘·§ ´ § "$ ‘· ¦ ¦
|
|||
|
|
§ ÜÍ 9Lß ô» ZÔn°—Nêb ©ª«¬¤ï ú ¨ ¨ ä‰\” ¨ ¨ Ü«4¶ ¨ ¨ ¾¹äÌ\× ¨ ¨ (Å b ô»® Àc ® "$ ¡ ¢ £ ¡ô» ¢ c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
£“² Å
|
|||
|
|
® űËÔð :D‚ ɼ §R8µ¥¥� °±Ô‘$œ ¯ ¯ ô»ä±,¼ ¯ ¯ “½8æ c ɼ³ ´ ³ "$ ɼ ² ²
|
|||
|
|
³ ä—m üçjG D `FramedParts` contains an export of the data of a Framed transport.Á ü¯kH E It can be used to construct a new [`Framed`] with a different codec.Á üøk< 9 It contains all current buffers and the inner transport.Á µl ú ü¹l$ Þ I\¢m ¥ µ ¦ ¶ µ ¶ Âü ®m µ€ ±m ÀÁ Ö"#òEVµ ·¸¹º».0 35 Lÿm üºm@ = The inner transport used to read bytes to and write bytes toÁƒn ´ ´ çºd¡n l�n
|
|||
|
|
The codecÁ,¥n ´ ´ íº´çn ü´n. + The buffer with read but unprocessed data.ÁDën ´ ´ ¾¹¼Æo ü„o= : A buffer with unprocessed data which are not written yet.ÁLÊo ´ ´ ¾¹¤×p ,âp ´ ´ ( çl d ¥ ½ ¦ ¾ ½ ¾ ÂüÞ µ€Ý Á� ®m ÂÈ ±m ÀÁ¿ Àc ¿ ~€ ¤ ¥ ¦ ¤ÀÁ ¥ c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
¦“² ¼ çl ¼
|
|||
|
|
¿çºíº+±2”›u ü—q7 4 Configure length delimited `LengthDelimitedCodec`s.Á Ïqú üÓqK H `Builder` enables constructing configured length delimited codecs. NoteÁ üŸrP M that not all configuration settings apply to both encoding and decoding. SeeÁ üðr; 8 the documentation for specific methods for more detail.Á ¬sú ü°sS P Note that the if the value of [`Builder::max_frame_length`] becomes larger thanÁ ü„tT Q what can actually fit in [`Builder::length_field_length`], it will be clipped toÁ üÙt# the maximum value that can fit.Á L<¦u ÊÆ f\
|
|||
|
|
ãv?, ÁÂÃÄÅƤÐulÐuó À À ¼ v„ vó À À Ôûvœûvó À À ÄâwŒâwó À À ¼þxDþxó À À ’ÒüÒy ÔÒyó À À (!†u e ÊÆÈ Àc È "$ § ¨ © §ÊÆ ¨ c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
©“² Ç !†u Ç
|
|||
|
|
È Å±Ë("�u
|
|||
|
|
f ÊÆ 0 4 f ÊÆË Ù Ë OQ ª ªÊÆ ÊÆ Ê "�u Ê
|
|||
|
|
Ë œ #”u g ÊÆ üº} üúzJ G A codec for frames delimited by a frame head specifying their lengths.Á Å{ú üÉ{O L This allows the consumer to work with entire frames without having to worryÁ ü™|+ ( about buffering or other framing logic.Á Å|ú üÉ|5 2 See [module level] documentation for more detail.Á ÿ|ú ôƒ} [module level]: index.htmlÁ M¤Å} ÜÇ ú,Q�Ÿ—Æ… ÎÏ„ü}<ü}ó Í Í ÊÆ”¥~,¥~ó Í Í ¨È($«} h ÜÇÑ Àc Ñ "$ « ¬ «ÜÇ ¬ c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
“² Ð $«} Ð
|
|||
|
|
Ñ Å±Ë(%²} i ÜÇÓ Ù Ó "$ ® ®ÜÇ ÜÇ Ò %²} Ò
|
|||
|
|
Ó o„Ú~ N\ß~ó ¨È [9ìMºÎÆ™ ÕÖ×Ø Ö Ø Ù ¨È $ñ~ Nó Ô Ô ¨È ó Ô Ô ¨ÈV° NV°ó Ô Ô
|
|||
|
|
Ø V°V° ó ¨È Ô Ô ýÛ ,€ó Ô Ô (&Å~ j ¨ÈÛ Àc Û "$ ¯ ° ± ¯¨È ° c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
±“² Ú &Å~ Ú
|
|||
|
|
Û Å±Ë('Ì~
|
|||
|
|
k ¨È 0 4 k ¨ÈÞ Ù Þ OQ ² ²¨È ¨È Ý 'Ì~ Ý
|
|||
|
|
Þ œ (Ó~ l ¨È ¬¾ üŒW T A simple [`Decoder`] and [`Encoder`] implementation that splits up data into lines.Á äú üèE B This uses the `\n` character as the line ending on all platforms.Á ®ú ü²&ø˜ üÙ&˜� QTÉ ¿Ê åØ`.�ó áâ㌽T½Ä à à ŒÑTÑÄ à à œÎlÎÄ à à (.‰ o ¿Êå Ù å "$ ³ ³¿Ê ¿Ê ä .‰ ä
|
|||
|
|
å o(/� p ¿Êç Àc ç "$ ´ µ ¶ ´¿Ê µ c c ˆ ¢cµ
|
|||
|
|
` £c¬k ` àB¤GS
|
|||
|
|
¶“² æ /� æ
|
|||
|
|
ç űË0— q ¿Êé › é " ( = · ·¿Ê è 0— è
|
|||
|
|
é ‡H1› r ¿Ê r ¿Êì ·ß ì 79 ¸ ¹ ¸¿Ê ¹¿Ê ë 1› ë
|
|||
|
|
ì ”¹
|
|||
|
|
š2¦ s ¿Êî » î "$ º » º¿Ê »¿Ê …º í 2¦ í
|
|||
|
|
î �¹
|
|||
|
|
‡P3« t ¿Êð ïß ð #% ¼ ½ ¼¿Ê ½¿Ê î» ï 3« ï
|
|||
|
|
ð ‚¹
|