org.apache.commons.net.io
Class FromNetASCIIOutputStream
FilterOutputStream
|
+--org.apache.commons.net.io.FromNetASCIIOutputStream
public final class FromNetASCIIOutputStream
extends FilterOutputStream
This class wraps an output stream, replacing all occurrences
of <CR><LF> (carriage return followed by a linefeed),
which is the NETASCII standard for representing a newline, with the
local line separator representation. You would use this class to
implement ASCII file transfers requiring conversion from NETASCII.
Because of the translation process, a call to
flush() will
not flush the last byte written if that byte was a carriage
return. A call to
close() , however, will
flush the carriage return.
- Daniel F. Savarese
synchronized void | close() |
synchronized void | write(int ch) |
synchronized void | write(byte[] buffer) |
synchronized void | write(byte[] buffer, int offset, int length) |
FromNetASCIIOutputStream
public FromNetASCIIOutputStream(OutputStream output)
Creates a FromNetASCIIOutputStream instance that wraps an existing
OutputStream.
- output - The OutputStream to wrap.
close
public synchronized void close()
Closes the stream, writing all pending data.
- If an error occurs while closing the stream.
write
public synchronized void write(byte[] buffer)
Writes a byte array to the stream.
- buffer - The byte array to write.
- If an error occurs while writing to the underlying
stream.
write
public synchronized void write(byte[] buffer, int offset, int length)
Writes a number of bytes from a byte array to the stream starting from
a given offset.
- buffer - The byte array to write.
- offset - The offset into the array at which to start copying data.
- length - The number of bytes to write.
- If an error occurs while writing to the underlying
stream.
write
public synchronized void write(int ch)
Writes a byte to the stream. Note that a call to this method
might not actually write a byte to the underlying stream until a
subsequent character is written, from which it can be determined if
a NETASCII line separator was encountered.
This is transparent to the programmer and is only mentioned for
completeness.
- ch - The byte to write.
- If an error occurs while writing to the underlying
stream.
flush()will not flush the last byte written if that byte was a carriage return. A call to close() , however, will flush the carriage return.