Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Clarify the usage the output I/O queues in the hooks #230

Merged
merged 2 commits into from
Sep 21, 2020
Merged

Clarify the usage the output I/O queues in the hooks #230

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
43c03f7
Editorial: Clarify the usage the output I/O queues in the hooks
Sep 17, 2020
eade6ff
Formatting fix
Sep 21, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion encoding.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -995,9 +995,16 @@ different format here, to be able to represent ranges.)
<p>The <a>get an encoding</a> algorithm is to be used to turn a <a>label</a> into an
<a for=/>encoding</a>.

<p>Standards are to ensure that the I/O queues they pass to the <a for=/>encode</a> and
<p>Standards are to ensure that the input I/O queues they pass to the <a for=/>encode</a> and
<a>UTF-8 encode</a> algorithms are effectively I/O queues of scalar values, i.e., they contain
no <a>surrogates</a>.

<p>These hooks, with the exception of <a>BOM sniff</a>, will block until the input I/O queue has
been consumed in its entirety. In order to use the output tokens as they are pushed into the
stream, callers are to invoke the hooks with an empty output I/O queue and read from it
<a>in parallel</a>. Note that some care is needed when using
<a>UTF-8 decode without BOM or fail</a>, as any error found during decoding will prevent the
<a>end-of-queue</a> item from ever being pushed into the output I/O queue.
</div>

<p>To <dfn export>decode</dfn> an I/O queue of bytes <var>ioQueue</var> given a fallback encoding
Expand Down