|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object
|
+--java.io.OutputStream
|
+--java.io.FilterOutputStream
|
+--java.io.PrintStream
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 class should be used in situations that require writing
characters rather than bytes.
PrintWriter
| Fields inherited from class java.io.FilterOutputStream |
out |
| Constructor Summary | |
PrintStream(OutputStream out)
Create a new print stream. |
|
PrintStream(OutputStream out,
boolean autoFlush)
Create a new print stream. |
|
| Method Summary | |
boolean |
checkError()
Flush the stream and check its error state. |
void |
close()
Close the stream. |
void |
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(Object obj)
Print an object. |
void |
print(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(Object x)
Print an Object and then terminate the line. |
void |
println(String x)
Print a String and then terminate the line. |
protected void |
setError()
Set the error state of the stream to true. |
void |
write(byte[] buf,
int off,
int len)
Write len bytes from the specified byte array starting at
offset off to this stream. |
void |
write(int b)
Write the specified byte to this stream. |
| Methods inherited from class java.io.FilterOutputStream |
write |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public PrintStream(OutputStream out)
out - The output stream to which values and objects will be
printedPrintWriter.PrintWriter(java.io.OutputStream)
public PrintStream(OutputStream out,
boolean autoFlush)
out - The output stream to which values and objects will be
printedautoFlush - A boolean; if true, the output buffer will be flushed
whenever a byte array is written, one of the
println methods is invoked, or a newline
character or byte ('\n') is writtenPrintWriter.PrintWriter(java.io.OutputStream, boolean)| Method Detail |
public void flush()
flush in class FilterOutputStreamOutputStream.flush()public void close()
close in class FilterOutputStreamOutputStream.close()public boolean checkError()
true when the underlying output stream throws an
IOException other than InterruptedIOException,
and when the setError method is invoked. If an operation
on the underlying output stream throws an
InterruptedIOException, then the PrintStream
converts the exception back into an interrupt by doing:
Thread.currentThread().interrupt();
or the equivalent.IOException other than
InterruptedIOException, or the
setError method has been invokedprotected void setError()
true.public void write(int b)
flush 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) or println(char)
methods.
write in class FilterOutputStreamb - The byte to be writtenprint(char),
println(char)
public void write(byte[] buf,
int off,
int len)
len bytes from the specified byte array starting at
offset off to this stream. If automatic flushing is
enabled then the flush 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) or println(char)
methods.
write in class FilterOutputStreambuf - A byte arrayoff - Offset from which to start taking byteslen - Number of bytes to writepublic void print(boolean b)
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 printedpublic void print(char c)
write(int) method.c - The char to be printedpublic void print(int i)
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 printedInteger.toString(int)public void print(long l)
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 printedLong.toString(long)public void print(float f)
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 printedFloat.toString(float)public void print(double d)
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 printedDouble.toString(double)public void print(char[] s)
write(int) method.s - The array of chars to be printedNullPointerException - If s is nullpublic void print(String s)
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 printedpublic void print(Object obj)
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 printedObject.toString()public void println()
line.separator, and is not necessarily a single newline
character ('\n').public void println(boolean x)
print(boolean) and then
println().x - The boolean to be printedpublic void println(char x)
print(char) and then
println().x - The char to be printed.public void println(int x)
print(int) and then
println().x - The int to be printed.public void println(long x)
print(long) and then
println().x - a The long to be printed.public void println(float x)
print(float) and then
println().x - The float to be printed.public void println(double x)
print(double) and then
println().x - The double to be printed.public void println(char[] x)
print(char[]) and
then println().x - an array of chars to print.public void println(String x)
print(String) and then
println().x - The String to be printed.public void println(Object x)
print(Object) and then
println().x - The Object to be printed.
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.