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:
java.io.Closeable
,java.io.Flushable
,java.lang.Appendable
,java.lang.AutoCloseable
public class PrintStream2 extends java.io.PrintStream
APrintStream
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, aPrintStream
never throws anIOException
; instead, exceptional situations merely set an internal flag that can be tested via thecheckError
method. Optionally, aPrintStream
can be created so as to flush automatically; this means that theflush
method is automatically invoked after a byte array is written, one of theprintln
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. ThePrintWriter
class should be used in situations that require writing characters rather than bytes.
Constructor Summary
Constructors Constructor Description PrintStream2(java.io.OutputStream out)
Create a new print stream.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
close()
Close the stream.protected void
ensureOpen()
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(java.lang.Object obj)
Print an object.void
print(java.lang.String s)
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
println(java.lang.Object x)
Print an Object and then terminate the line.void
println(java.lang.String x)
Print a String and then terminate the line.void
setNewOutput(java.io.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.
Method Detail
setNewOutput
public void setNewOutput(java.io.OutputStream out)
Sets a new output stream for the output. This is used by the rotate trace files.
ensureOpen
protected void ensureOpen() throws java.io.IOException
Check to make sure that the stream has not been closed- Throws:
java.io.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 interfacejava.io.Flushable
- Overrides:
flush
in classjava.io.PrintStream
- See Also:
OutputStream.flush()
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 interfacejava.lang.AutoCloseable
- Specified by:
close
in interfacejava.io.Closeable
- Overrides:
close
in classjava.io.PrintStream
- See Also:
OutputStream.close()
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 classjava.io.PrintStream
- Parameters:
b
- The byte to be written- See Also:
print(char)
,println(char)
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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- Parameters:
i
- Theint
to be printed- See Also:
Integer.toString(int)
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 classjava.io.PrintStream
- Parameters:
l
- Thelong
to be printed- See Also:
Long.toString(long)
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 classjava.io.PrintStream
- Parameters:
f
- Thefloat
to be printed- See Also:
Float.toString(float)
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 classjava.io.PrintStream
- Parameters:
d
- Thedouble
to be printed- See Also:
Double.toString(double)
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 classjava.io.PrintStream
- Parameters:
s
- The array of chars to be printed- Throws:
java.lang.NullPointerException
- Ifs
isnull
print
public void print(java.lang.String s)
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 classjava.io.PrintStream
- Parameters:
s
- TheString
to be printed
print
public void print(java.lang.Object obj)
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 classjava.io.PrintStream
- Parameters:
obj
- TheObject
to be printed- See Also:
Object.toString()
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 classjava.io.PrintStream
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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- 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 classjava.io.PrintStream
- Parameters:
x
- an array of chars to print.
println
public void println(java.lang.String x)
Print a String and then terminate the line. This method behaves as though it invokes
and thenprint(String)
.println()
- Overrides:
println
in classjava.io.PrintStream
- Parameters:
x
- TheString
to be printed.
println
public void println(java.lang.Object x)
Print an Object and then terminate the line. This method behaves as though it invokes
and thenprint(Object)
.println()
- Overrides:
println
in classjava.io.PrintStream
- Parameters:
x
- TheObject
to be printed.