dotnet-api-docs icon indicating copy to clipboard operation
dotnet-api-docs copied to clipboard

Zero-bytes read not documented on QuicStream

Open PatrikTrefil opened this issue 4 months ago • 7 comments

Type of issue

Missing information

Description

ReadAsync operations on QuicStream have special semantics for so called zero-byte reads, but this behavior is not documented.

This behavior can also be found in NetworkStream.ReadAsync. The behavior of these methods is in this case documented in the return value descriptions:

... If zero bytes are requested, read operations may complete immediately or may not complete until at least one byte is available (but without consuming any data).

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.net.quic.quicstream.readasync?view=net-9.0#system-net-quic-quicstream-readasync(system-memory((system-byte))-system-threading-cancellationtoken)

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Net.Quic/QuicStream.xml

Document Version Independent Id

1477526e-889e-2845-22a4-e5f351b7e3b5

Platform Id

9ef5f718-3f56-4f6c-74e1-39f55d00884a

Article author

@karelz

PatrikTrefil avatar Sep 15 '25 13:09 PatrikTrefil