|
MID Profile | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.io.OutputStream | +--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.
Constructor Summary | |
PrintStream(OutputStream out)
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(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(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.OutputStream |
write |
Methods inherited from class java.lang.Object |
equals, 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
printedMethod Detail |
public void flush()
flush
in class OutputStream
OutputStream.flush()
public void close()
close
in class OutputStream
OutputStream.close()
public boolean checkError()
true
when the underlying output stream throws an
IOException
,
and when the setError
method is invoked.IOException
, 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 OutputStream
b
- 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 OutputStream
buf
- 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(char[] s)
write(int)
method.s
- The array of chars to be printedNullPointerException
- If s
is null
public 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(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.
|
MID Profile | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |