Write text to a character-output stream, buffering characters so as
to provide for the efficient writing of single characters, arrays,
and strings.
Provide support for discarding for the output that has been
buffered.
This needs revisiting when the buffering problems in the JSP spec
are fixed -akv
clear
public final void clear()
throws IOException
Discard the output buffer.
clearBuffer
public void clearBuffer()
throws IOException
close
public void close()
throws IOException
Close the stream.
flush
public void flush()
throws IOException
Flush the stream.
flushBuffer
protected final void flushBuffer()
throws IOException
Flush the output buffer to the underlying character stream, without
flushing the stream itself. This method is non-private only so that it
may be invoked by PrintStream.
getRemaining
public int getRemaining()
- the number of bytes unused in the buffer
newLine
public void newLine()
throws IOException
Write a line separator. The line separator string is defined by the
system property line.separator, and is not necessarily a single
newline ('\n') character.
print
public void print(Object obj)
throws IOException
Print an object. The string produced by the
java.lang.String.valueOf(Object)
method is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
obj
- The Object
to be printed
print
public void print(String s)
throws IOException
Print a string. If the argument is
null
then the string
"null"
is printed. Otherwise, the string's characters are
converted into bytes according to the platform's default character
encoding, and these bytes are written in exactly the manner of the
write(int)
method.
s
- The String
to be printed
print
public void print(boolean b)
throws IOException
Print a boolean value. The string produced by
java.lang.String.valueOf(boolean)
is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
b
- The boolean
to be printed
print
public void print(char c)
throws IOException
Print a character. The character is translated into one or more bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
c
- The char
to be printed
print
public void print(double d)
throws IOException
Print a double-precision floating-point number. The string produced by
java.lang.String.valueOf(double)
is translated into
bytes according to the platform's default character encoding, and these
bytes are written in exactly the manner of the
write(int)
method.
d
- The double
to be printed
print
public void print(float f)
throws IOException
Print a floating-point number. The string produced by
java.lang.String.valueOf(float)
is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
f
- The float
to be printed
print
public void print(int i)
throws IOException
Print an integer. The string produced by
java.lang.String.valueOf(int)
is translated into bytes according
to the platform's default character encoding, and these bytes are
written in exactly the manner of the
write(int)
method.
i
- The int
to be printed
print
public void print(long l)
throws IOException
Print a long integer. The string produced by
java.lang.String.valueOf(long)
is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
l
- The long
to be printed
print
public void print(s[] )
throws IOException
Print an array of characters. The characters are converted into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
println
public void println()
throws IOException
Terminate the current line by writing the line separator string. The
line separator string is defined by the system property
line.separator
, and is not necessarily a single newline
character ('\n'
).
Need to change this from PrintWriter because the default
println() writes to the sink directly instead of through the
write method...
println
public void println(Object x)
throws IOException
Print an Object and then terminate the line. This method behaves as
though it invokes
print(Object)
and then
println()
.
println
public void println(String x)
throws IOException
Print a String and then terminate the line. This method behaves as
though it invokes
print(String)
and then
println()
.
println
public void println(boolean x)
throws IOException
Print a boolean value and then terminate the line. This method behaves
as though it invokes
print(boolean)
and then
println()
.
println
public void println(char x)
throws IOException
Print a character and then terminate the line. This method behaves as
though it invokes
print(char)
and then
println()
.
println
public void println(double x)
throws IOException
Print a double-precision floating-point number and then terminate the
line. This method behaves as though it invokes
print(double)
and then
println()
.
println
public void println(float x)
throws IOException
Print a floating-point number and then terminate the line. This method
behaves as though it invokes
print(float)
and then
println()
.
println
public void println(int x)
throws IOException
Print an integer and then terminate the line. This method behaves as
though it invokes
print(int)
and then
println()
.
println
public void println(long x)
throws IOException
Print a long integer and then terminate the line. This method behaves
as though it invokes
print(long)
and then
println()
.
println
public void println(x[] )
throws IOException
Print an array of characters and then terminate the line. This method
behaves as though it invokes
print(char[])
and then
println()
.
write
public void write(String s)
throws IOException
Write a string. This method cannot be inherited from the Writer class
because it must suppress I/O exceptions.
write
public void write(String s,
int off,
int len)
throws IOException
Write a portion of a String.
s
- String to be writtenoff
- Offset from which to start reading characterslen
- Number of characters to be written
write
public void write(buf[] )
throws IOException
Write an array of characters. This method cannot be inherited from the
Writer class because it must suppress I/O exceptions.
write
public void write(cbuf[] ,
int off,
int len)
throws IOException
Write a portion of an array of characters.
Ordinarily this method stores characters from the given array into
this stream's buffer, flushing the buffer to the underlying stream as
needed. If the requested length is at least as large as the buffer,
however, then this method will flush the buffer and write the characters
directly to the underlying stream. Thus redundant
DiscardableBufferedWriter
s will not copy data unnecessarily.
off
- Offset from which to start reading characterslen
- Number of characters to write
write
public void write(int c)
throws IOException
Write a single character.