Package com.iizix.server
Class PrintStream2
java.lang.Object
java.io.OutputStream
java.io.FilterOutputStream
java.io.PrintStream
com.iizix.server.PrintStream2
- All Implemented Interfaces:
Closeable
,Flushable
,Appendable
,AutoCloseable
A
PrintStream
adds functionality to another output stream, namely the ability to print representations of various data values conveniently. Two other features are provided as well. Unlike other output streams, a PrintStream
never throws an IOException
; instead, exceptional situations merely set an internal flag that can be tested via the checkError
method. Optionally, a PrintStream
can be created so as to flush automatically; this means that the flush
method is automatically invoked after a byte array is written, one of the println
methods is invoked, or a newline character or byte ('\n'
) is written.All characters printed by a PrintStream
are converted into bytes using the platform's default character encoding. The PrintWriter
class should be used in situations that require writing characters rather than bytes.
Field Summary
Fields inherited from class java.io.FilterOutputStream
out
Constructor Summary
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Close the stream.protected void
Check to make sure that the stream has not been closedvoid
flush()
Flush the stream.void
print
(boolean b) Print a boolean value.void
print
(char c) Print a character.void
print
(char[] s) Print an array of characters.void
print
(double d) Print a double-precision floating-point number.void
print
(float f) Print a floating-point number.void
print
(int i) Print an integer.void
print
(long l) Print a long integer.void
Print an object.void
Print a string.void
println()
Terminate the current line by writing the line separator string.void
println
(boolean x) Print a boolean and then terminate the line.void
println
(char x) Print a character and then terminate the line.void
println
(char[] x) Print an array of characters and then terminate the line.void
println
(double x) Print a double and then terminate the line.void
println
(float x) Print a float and then terminate the line.void
println
(int x) Print an integer and then terminate the line.void
println
(long x) Print a long and then terminate the line.void
Print an Object and then terminate the line.void
Print a String and then terminate the line.void
setNewOutput
(OutputStream out) Sets a new output stream for the output.void
write
(byte[] buf, int off, int len) Writelen
bytes from the specified byte array starting at offsetoff
to this stream.void
write
(int b) Write the specified byte to this stream.Methods inherited from class java.io.PrintStream
append, append, append, charset, checkError, clearError, format, format, printf, printf, setError, write, writeBytes
Methods inherited from class java.io.OutputStream
nullOutputStream
Constructor Details
PrintStream2
Create a new print stream.- Parameters:
out
- The output stream to which values and objects will be printed- See Also:
Method Details
setNewOutput
Sets a new output stream for the output. This is used by the rotate trace files.ensureOpen
Check to make sure that the stream has not been closed- Throws:
IOException
flush
public void flush()Flush the stream. This is done by writing any buffered output bytes to the underlying output stream and then flushing that stream.- Specified by:
flush
in interfaceFlushable
- Overrides:
flush
in classPrintStream
- See Also:
close
public void close()Close the stream. This is done by flushing the stream and then closing the underlying output stream.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Overrides:
close
in classPrintStream
- See Also:
write
public void write(int b) Write the specified byte to this stream. If the byte is a newline and automatic flushing is enabled then theflush
method will be invoked.Note that the byte is written as given; to write a character that will be translated according to the platform's default character encoding, use the
print(char)
orprintln(char)
methods.- Overrides:
write
in classPrintStream
- Parameters:
b
- The byte to be written- See Also:
write
public void write(byte[] buf, int off, int len) Writelen
bytes from the specified byte array starting at offsetoff
to this stream. If automatic flushing is enabled then theflush
method will be invoked.Note that the bytes will be written as given; to write characters that will be translated according to the platform's default character encoding, use the
print(char)
orprintln(char)
methods.- Overrides:
write
in classPrintStream
- Parameters:
buf
- A byte arrayoff
- Offset from which to start taking byteslen
- Number of bytes to write
print
public void print(boolean b) Print a boolean value. The string produced by
is translated into bytes according to the platform's default character encoding, and these bytes are written in exactly the manner of theString.valueOf(boolean)
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
b
- Theboolean
to be printed
print
public void print(char c) 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
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
c
- Thechar
to be printed
print
public void print(int i) Print an integer. The string produced by
is translated into bytes according to the platform's default character encoding, and these bytes are written in exactly the manner of theString.valueOf(int)
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
i
- Theint
to be printed- See Also:
print
public void print(long l) Print a long integer. The string produced by
is translated into bytes according to the platform's default character encoding, and these bytes are written in exactly the manner of theString.valueOf(long)
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
l
- Thelong
to be printed- See Also:
print
public void print(float f) Print a floating-point number. The string produced by
is translated into bytes according to the platform's default character encoding, and these bytes are written in exactly the manner of theString.valueOf(float)
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
f
- Thefloat
to be printed- See Also:
print
public void print(double d) Print a double-precision floating-point number. The string produced by
is translated into bytes according to the platform's default character encoding, and these bytes are written in exactly the manner of theString.valueOf(double)
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
d
- Thedouble
to be printed- See Also:
print
public void print(char[] s) 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
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
s
- The array of chars to be printed- Throws:
NullPointerException
- Ifs
isnull
print
Print a string. If the argument isnull
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
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
s
- TheString
to be printed
print
Print an object. The string produced by the
method is translated into bytes according to the platform's default character encoding, and these bytes are written in exactly the manner of theString.valueOf(Object)
method.write(int)
- Overrides:
print
in classPrintStream
- Parameters:
obj
- TheObject
to be printed- See Also:
println
public void println()Terminate the current line by writing the line separator string. The line separator string is defined by the system propertyline.separator
, and is not necessarily a single newline character ('\n'
).- Overrides:
println
in classPrintStream
println
public void println(boolean x) Print a boolean and then terminate the line. This method behaves as though it invokes
and thenprint(boolean)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- Theboolean
to be printed
println
public void println(char x) Print a character and then terminate the line. This method behaves as though it invokes
and thenprint(char)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- Thechar
to be printed.
println
public void println(int x) Print an integer and then terminate the line. This method behaves as though it invokes
and thenprint(int)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- Theint
to be printed.
println
public void println(long x) Print a long and then terminate the line. This method behaves as though it invokes
and thenprint(long)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- a Thelong
to be printed.
println
public void println(float x) Print a float and then terminate the line. This method behaves as though it invokes
and thenprint(float)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- Thefloat
to be printed.
println
public void println(double x) Print a double and then terminate the line. This method behaves as though it invokes
and thenprint(double)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- Thedouble
to be printed.
println
public void println(char[] x) Print an array of characters and then terminate the line. This method behaves as though it invokes
and thenprint(char[])
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- an array of chars to print.
println
Print a String and then terminate the line. This method behaves as though it invokes
and thenprint(String)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- TheString
to be printed.
println
Print an Object and then terminate the line. This method behaves as though it invokes
and thenprint(Object)
.println()
- Overrides:
println
in classPrintStream
- Parameters:
x
- TheObject
to be printed.