70 lines
14 KiB
Plaintext
70 lines
14 KiB
Plaintext
|
rust
|
|||
|
|
{7 #rustc 1.96.0 (ac68faa20 2026-05-25)ÁíàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ‰ ¤, »¤Œ¡ À î »À|Ï if_allocÁDª4 »¤Œ’4 í SinkÁ › ErrorÁ
|
|||
|
|
poll_readyÁ
|
|||
|
|
start_sendÁ
|
|||
|
|
poll_flushÁ
|
|||
|
|
poll_closeÁ ¤ › Š – § ¸ É ¡ › Š – § ¸ É
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
8¤› „¾„¾ PinÁ †¾‰ ˜X $ ]È=„kt• ¡›
|
|||
|
|
„¾ í DerefMutÁDƒ ö! å œ „¾ k<² Ì� ·$» œØ ü ¤G ´ Asynchronous sinksÁ ú üG D This crate contains the `Sink` trait which allows values to be sentÁ œc asynchronously.Á ü·6 ü÷6 |” í( ¼! ö! å „¾ k Ì� · œØ €ƒ†œø ut‘ iT¥ ]`OR¤Ä üÃL I A `Sink` is a value into which other values can be sent, asynchronously.Á � ú ü”8 5 Basic examples of sinks include the sending side of:Á Í ú tÑ - ChannelsÁ là
|
|||
|
|
- SocketsÁ \î - PipesÁ ú ú üþK H In addition to such "primitive" sinks, it's typical to layer additionalÁ üÊA > functionality, such as buffering, on top of an existing sink.Á Œ ú ü�N K Sending to a sink is "asynchronous" in the sense that the value may not beÁ üßM J sent in its entirety immediately. Instead, values are sent in a two-phaseÁ üM J way: first by initiating a send, and then by polling for completion. ThisÁ üûO L two-phase setup is analogous to buffered writing in synchronous code, whereÁ üË I F writes often succeed immediately, but internally are buffered and areÁ ü•
|
|||
|
|
* ' *actually* written only upon flushing.Á À
|
|||
|
|
ú üÄ
|
|||
|
|
P M In addition, the `Sink` may be *full*, in which case it is not even possibleÁ ü• ! to start the sending process.Á · ú ü» L I As with `Future` and `Stream`, the `Sink` trait is built from a few coreÁ üˆ D A required methods, and a host of default methods for working in aÁ üÍ F C higher-level way. The `Sink::send_all` combinator is of particularÁ ü”
|
|||
|
|
K H importance: you can use it to send an entire stream to a sink, which isÁ üà
|
|||
|
|
4 1 the simplest way to ultimately consume a stream.Á .ü•. sinks do nothing unless polledÁ $Î › Îì üÄ« Íì“ $Ó Þ( Þ-
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Íìæ“
|
|||
|
|
\¤ ¦
|
|||
|
|
WY T¤ üß@ = The type of value produced by the sink when an error occurs.Á,© ü„[ üµ6 3 Attempts to prepare the `Sink` to receive a value.Á ð ú üøH E This method must be called and return `Poll::Ready(Ok(()))` prior toÁ ôÅ each call to `start_send`.Á è ú üðJ G This method returns `Poll::Ready` once the underlying sink is ready toÁ ü¿J G receive data. If this method returns `Poll::Pending`, the current taskÁ üŽS P is registered to be notified (via `cx.waker().wake_by_ref()`) when `poll_ready`Á Üæ should be called again.Á † ú üŽA > In most cases, if the sink encounters an error, the sink willÁ üÔ+ ( permanently be unable to receive items.ÁT‡ !„¾„¾ å †¾‰ ˜X $ ]È=„kt• æ Ì�Ì� k Î� wakerÁ¸� Ï� local_wakerÁ¸� Ð� extÁ¸� Ñ� _markerÁ¸� Ò� _marker2Á¸� f'EwÚ]¾å !œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
® œ
|
|||
|
|
æ“$’ cxÁ¨ ü¾ K üå5 2 Begin the process of sending a value to the sink.Á üŸG D Each call to this function must be preceded by a successful call toÁ üë6 3 `poll_ready` which returned `Poll::Ready(Ok(()))`.Á ¦ ú ü®J G As the name suggests, this method only *begins* the process of sendingÁ üýK H the item. If the sink employs buffering, the item isn't fully processedÁ üÍL I until the buffer is fully flushed. Since sinks are designed to work withÁ üžH E asynchronous I/O, the process of actually writing out the data to anÁ üëB ? underlying object takes place asynchronously. **You *must* useÁ ü²F C `poll_flush` or `poll_close` in order to guarantee completion of aÁ \ý send**.Á � ú ü•I F Implementations of `poll_ready` and `start_send` will usually involveÁ üãF C flushing behind the scenes in order to make room for new messages.Á ü®K H It is only necessary to call `poll_flush` if you need to guarantee thatÁ üþ= : *all* of the items placed into the `Sink` have been sent.Á À ú üÈ A Ö üŽ + ¡TÁ "„¾„¾ å †¾‰ ˜X $ ]È=„kt• "æ“� Ö
|
|||
|
|
æ“$Ì ÷$â üë"[ ü� . + Flush any remaining output from this sink.Á  ú üÊ H E Returns `Poll::Ready(Ok(()))` when no buffered items remain. If thisÁ ü— I F value is returned then it is guaranteed that all previous values sentÁ üå ' $ via `start_send` have been flushed.Á ‘ ú ü™ F C Returns `Poll::Pending` if there is more work left to do, in whichÁ üä W T case the current task is scheduled (via `cx.waker().wake_by_ref()`) to wake up whenÁ üÀ!( % `poll_flush` should be called again.Á í! ú üõ!A Ö ü»"+ ¡Tî" # $ %„¾„¾ å †¾‰ ˜X $ ]È=„kt• #æ $Ì�Ì� k Î�Ì ¸� Ï�ß ¸� Ð�ø ¸� Ñ�‰ ¸� Ò�ž ¸� f'EwÚ]¾å %Ê ƒ#
|
|||
|
|
|
|||
|
|
æ“$ù" ˆ �# ü’([ üÌ#A > Flush any remaining output and close this sink, if necessary.Á ’$ ú üš$L I Returns `Poll::Ready(Ok(()))` when no buffered items remain and the sinkÁ üë$! has been successfully closed.Á ‘% ú ü™%F ¥+ üä%W õ+ üÀ&( % `poll_close` should be called again.Á í& ú üõ&J G If this function encounters an error, the sink should be considered toÁ üÄ'I F have failed permanently, and no more `Sink` methods should be called.ÁT•( & ' („¾„¾ å †¾‰ ˜X $ ]È=„kt• &æ 'Ì�Ì� k Î�Ì ¸� Ï�ß ¸� Ð�ø ¸� Ñ�‰ ¸� Ò�ž ¸� f'EwÚ]¾å (Ê ª(
|
|||
|
|
æ“$ ( ˆ ¶( üñ(@ 8 ) ¤
|
|||
|
|
|
|||
|
|
]_ Z\ T¸) ,½) ÆÍ
|
|||
|
|
üÔ)^ T×) * + ,„¾„¾ å †¾‰ ˜X $ ]È=„kt• *Á +Ì�Ì� k Î�Ì ¸� Ï�ß ¸� Ð�ø ¸� Ñ�‰ ¸� Ò�ž ¸� f'EwÚ]¾å ,œØžØ ŸØÈ Øˆ ¡Ø¢Ø´ ‰‰Nµý¤ÃÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ý ÁÍ
|
|||
|
|
ð)
|
|||
|
|
8ÆÍ$æ) ˆ ü) üí*N Tð* -„¾„¾ å †¾‰ ˜X $ ]È=„kt• -ÁÍŸ: ‰+
|
|||
|
|
8ÆÍ$ÿ* ÷$•+ üø+^ Tû+ . / 0„¾„¾ å †¾‰ ˜X $ ]È=„kt• .Á /Ì�Ì� k Î�Ì ¸� Ï�ß ¸� Ð�ø ¸� Ñ�‰ ¸� Ò�ž ¸� f'EwÚ]¾å 0Ú9 ”,
|
|||
|
|
8ÆÍ$Š, ˆ , ü‘-^ T”- 1 2 3„¾„¾ å †¾‰ ˜X $ ]È=„kt• 1Á 2Ì�Ì� k Î�Ì ¸� Ï�ß ¸� Ð�ø ¸� Ñ�‰ ¸� Ò�ž ¸� f'EwÚ]¾å 3Ú9 -
|
|||
|
|
8ÆÍ$£- ˆ ¹- ü¨.] ¡ › Íì� . ò$°. ö!� DÙ. “í� ,ä. � ê!“ Tú. Ù
|
|||
|
|
|
|||
|
|
jl pr TŒ/ ,‘/ ÕA“
|