public class PrintStream
- Object
- OutputStream
- PrintStream
ImplementsAutoCloseable
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.
All characters printed by a PrintStream are converted into bytes using the platform’s default character encoding.
Since: JDK1.0, CLDC 1.0
Constructors
public PrintStream(OutputStream out) | Create a new print stream. |
public PrintStream(OutputStream out, boolean autoFlush, String charsetName)
throws UnsupportedEncodingException | Create a new print stream that encodes with the named charset, optionally flushing automatically. |
Methods
public boolean checkError() | Flush the stream and check its error state. |
public void close() | Close the stream. |
public void flush() | Flush the stream. |
public void print(boolean b) | Print a boolean value. |
public void print(char c) | Print an array of characters. |
public void print(double d) | Print a double-precision floating point number. |
public void print(float f) | Print a floating point number. |
public void print(int i) | Print an integer. |
public void print(long l) | Print a long integer. |
public void print(Object obj) | Print an object. |
public void print(String s) | Print a string. |
public void println() | Terminate the current line by writing the line separator string. |
public void println(boolean x) | Print a boolean and then terminate the line. |
public void println(char x) | Print an array of characters and then terminate the line. |
public void println(double x) | Print a double and then terminate the line. |
public void println(float x) | Print a float and then terminate the line. |
public void println(int x) | Print an integer and then terminate the line. |
public void println(long x) | Print a long and then terminate the line. |
public void println(Object x) | Print an Object and then terminate the line. |
public void println(String x) | Print a String and then terminate the line. |
protected void setError() | Set the error state of the stream to true. |
public void write(byte[] buf, int off, int len) | Write len bytes from the specified byte array starting at offset off to this stream. |
public void write(int b) | Write the specified byte to this stream. |
Inherited methods
From OutputStream
Constructor details
PrintStream
public PrintStream(OutputStream out)Create a new print stream. This stream will not flush automatically.
out - The output stream to which values and objects will be printed
PrintStream
public PrintStream(OutputStream out, boolean autoFlush, String charsetName)
throws UnsupportedEncodingExceptionCreate a new print stream that encodes with the named charset, optionally flushing automatically.
Method details
checkError
public boolean checkError()Flush the stream and check its error state. The internal error state is set to true when the underlying output stream throws an IOException, and when the setError method is invoked.
close
public void close()Close the stream. This is done by flushing the stream and then closing the underlying output stream.
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.
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 the
method.
public void print(char c)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.
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 the
method.
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 the
method.
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 the
method.
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 the
method.
public void print(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 the
method.
public void print(String s)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
method.
println
public void println()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’).
println
public void println(boolean x)Print a boolean and then terminate the line. This method behaves as though it invokes
and then
.
println
public void println(char x)Print an array of characters and then terminate the line. This method behaves as though it invokes
and then
.
println
public void println(double x)Print a double and then terminate the line. This method behaves as though it invokes
and then
.
println
public void println(float x)Print a float and then terminate the line. This method behaves as though it invokes
and then
.
println
public void println(int x)Print an integer and then terminate the line. This method behaves as though it invokes
and then
.
println
public void println(long x)Print a long and then terminate the line. This method behaves as though it invokes
and then
.
println
public void println(Object x)Print an Object and then terminate the line. This method behaves as though it invokes
and then
.
println
public void println(String x)Print a String and then terminate the line. This method behaves as though it invokes
and then
.
setError
protected void setError()Set the error state of the stream to true.
write
public void write(byte[] buf, int off, int len)Write len bytes from the specified byte array starting at offset off to this stream.
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) or println(char) methods.
write
public void write(int b)Write the specified byte to this stream.
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) or println(char) methods.