Set the high- and low-water limits for write flow control.
These two values control when call the protocol's $(D_PSYMBOL
pauseWriting()) and $(D_PSYMBOL resumeWriting()) methods are called. If
specified, the low-water limit must be less than or equal to the
high-water limit.
The defaults are implementation-specific. If only the high-water limit
is given, the low-water limit defaults to a implementation-specific value
less than or equal to the high-water limit. Setting $(D_PSYMBOL high) to
zero forces low to zero as well, and causes $(D_PSYMBOL pauseWriting())
to be called whenever the buffer becomes non-empty. Setting $(D_PSYMBOL
low) to zero causes $(D_PSYMBOL resumeWriting()) to be called only once
the buffer is empty. Use of zero for either limit is generally
sub-optimal as it reduces opportunities for doing I/O and computation
concurrently.
Set the high- and low-water limits for write flow control.
These two values control when call the protocol's $(D_PSYMBOL pauseWriting()) and $(D_PSYMBOL resumeWriting()) methods are called. If specified, the low-water limit must be less than or equal to the high-water limit.
The defaults are implementation-specific. If only the high-water limit is given, the low-water limit defaults to a implementation-specific value less than or equal to the high-water limit. Setting $(D_PSYMBOL high) to zero forces low to zero as well, and causes $(D_PSYMBOL pauseWriting()) to be called whenever the buffer becomes non-empty. Setting $(D_PSYMBOL low) to zero causes $(D_PSYMBOL resumeWriting()) to be called only once the buffer is empty. Use of zero for either limit is generally sub-optimal as it reduces opportunities for doing I/O and computation concurrently.