| java.lang.Object java.io.OutputStream java.io.FilterOutputStream java.io.PrintStream
PrintStream | public class PrintStream extends FilterOutputStream implements Appendable,Closeable(Code) | | PrintStream is a class which takes an OutputStream and provides convenience
methods for printing common data types in a human readable format on the
stream. This is not to be confused with DataOutputStream which is used for
encoding common data types so that they can be read back in. No IOExceptions
are thrown by this class. Instead, callers should call checkError() to see if
a problem has been encountered in this Stream.
|
Constructor Summary | |
public | PrintStream(OutputStream out) Constructs a new PrintStream on the OutputStream out . | public | PrintStream(OutputStream out, boolean autoflush) Constructs a new PrintStream on the OutputStream out . | public | PrintStream(OutputStream out, boolean autoflush, String enc) Constructs a new PrintStream on the OutputStream out . | public | PrintStream(File file) Constructs a new PrintStream on the file file . | public | PrintStream(File file, String csn) Constructs a new PrintStream on the file file . | public | PrintStream(String fileName) Constructs a new PrintStream on the file the name of which isfileName .
All writes to the target can now take place through this PrintStream. | public | PrintStream(String fileName, String csn) Constructs a new PrintStream on the file the name of which isfileName .
All writes to the target can now take place through this PrintStream. |
Method Summary | |
public PrintStream | append(char c) Append a char c to the PrintStream. | public PrintStream | append(CharSequence csq) Append a CharSequence csq to the PrintStream. | public PrintStream | append(CharSequence csq, int start, int end) Append a subsequence of a CharSequence csq to the
PrintStream. | public boolean | checkError() Answers a boolean indicating whether or not this PrintStream has
encountered an error. | public synchronized void | close() Close this PrintStream. | public synchronized void | flush() Flush this PrintStream to ensure all pending data is sent out to the
target OutputStream. | public PrintStream | format(String format, Object... args) Writes a string formatted by an intermediate Formatter to
this stream using the given format string and arguments.
The method uses the default for the current JVM instance locale, as if it
is specified by the Locale.getDefault() call.
Parameters: format - A format string. Parameters: args - The arguments list. | public PrintStream | format(Locale l, String format, Object... args) Writes a string formatted by an intermediate Formatter to
this stream using the given format string and arguments.
Parameters: l - The locale used in the method. | public void | print(char[] charArray) Prints the String representation of the character array parameter
charArray to the target OutputStream. | public void | print(char ch) Prints the String representation of the character parameter
ch to the target OutputStream. | public void | print(double dnum) Prints the String representation of the double parameter
dnum to the target OutputStream. | public void | print(float fnum) Prints the String representation of the float parameter
fnum to the target OutputStream. | public void | print(int inum) Obtains the int argument as a String and
prints it to the target
OutputStream . | public void | print(long lnum) Prints the String representation of the long parameter
lnum to the target OutputStream. | public void | print(Object obj) Prints the String representation of the Object parameter obj
to the target OutputStream. | public synchronized void | print(String str) Prints the String representation of the String parameter
str to the target OutputStream. | public void | print(boolean bool) Prints the String representation of the boolean parameter
bool to the target OutputStream. | public PrintStream | printf(String format, Object... args) Prints a formatted string. | public PrintStream | printf(Locale l, String format, Object... args) Prints a formatted string. | public void | println() Prints the String representation of the System property
"line.separator" to the target OutputStream. | public void | println(char[] charArray) Prints the String representation of the character array parameter
charArray to the target OutputStream followed by the
System property "line.separator" . | public void | println(char ch) Prints the String representation of the character parameter
ch to the target OutputStream followed by the System
property "line.separator" . | public void | println(double dnum) Prints the String representation of the double parameter
dnum to the target OutputStream followed by the System
property "line.separator" . | public void | println(float fnum) Prints the String representation of the float parameter
fnum to the target OutputStream followed by the System
property "line.separator" . | public void | println(int inum) Obtains the int argument as a String and
prints it to the target
OutputStream followed by the System
property "line.separator" . | public void | println(long lnum) Prints the String representation of the long parameter
lnum to the target OutputStream followed by the System
property "line.separator" . | public void | println(Object obj) Prints the String representation of the Object parameter
obj to the target OutputStream followed by the System
property "line.separator" . | public synchronized void | println(String str) Prints the String representation of the String parameter
str to the target OutputStream followed by the System
property "line.separator" . | public void | println(boolean bool) Prints the String representation of the boolean parameter
bool to the target OutputStream followed by the System
property "line.separator" . | protected void | setError() | public void | write(byte[] buffer, int offset, int count) Writes count bytes from the byte array
buffer starting at offset to this
PrintStream. | public synchronized void | write(int oneByte) Writes the specified byte oneByte to this PrintStream.
Only the low order byte of oneByte is written. |
PrintStream | public PrintStream(OutputStream out)(Code) | | Constructs a new PrintStream on the OutputStream out . All
writes to the target can now take place through this PrintStream. By
default, the PrintStream is set to not autoflush when a newline is
encountered.
Parameters: out - the OutputStream to provide convenience methods on. |
PrintStream | public PrintStream(OutputStream out, boolean autoflush)(Code) | | Constructs a new PrintStream on the OutputStream out . All
writes to the target can now take place through this PrintStream. The
PrintStream is set to not autoflush if autoflush is
true .
Parameters: out - the OutputStream to provide convenience methods on. Parameters: autoflush - indicates whether or not to flush contents upon encountering anewline sequence. |
PrintStream | public PrintStream(OutputStream out, boolean autoflush, String enc) throws UnsupportedEncodingException(Code) | | Constructs a new PrintStream on the OutputStream out . All
writes to the target can now take place through this PrintStream. The
PrintStream is set to not autoflush if autoflush is
true .
Parameters: out - the OutputStream to provide convenience methods on. Parameters: autoflush - indicates whether or not to flush contents upon encountering anewline sequence. Parameters: enc - the non-null String describing the desired character encoding. throws: UnsupportedEncodingException - If the chosen encoding is not supported |
PrintStream | public PrintStream(File file) throws FileNotFoundException(Code) | | Constructs a new PrintStream on the file file . All writes
to the target can now take place through this PrintStream. Its encoding
character set is the default charset in the VM.
Parameters: file - the file to provide convenience methods on. throws: FileNotFoundException - if the file does not exist or cannot be opened to write. Orthe file cannot be created or any problem when open the fileto write. throws: SecurityException - if the security manager exists and denies the write to thefile. |
PrintStream | public PrintStream(File file, String csn) throws FileNotFoundException, UnsupportedEncodingException(Code) | | Constructs a new PrintStream on the file file . All writes
to the target can now take place through this PrintStream. Its encoding
character set name is csn .
Parameters: file - the file to provide convenience methods on. Parameters: csn - the character set name throws: FileNotFoundException - if the file does not exist or cannot be opened to write. Orthe file cannot be created or any problem when open the fileto write. throws: SecurityException - if the security manager exists and denies the write to thefile. throws: UnsupportedEncodingException - if the chosen character set is not supported |
PrintStream | public PrintStream(String fileName) throws FileNotFoundException(Code) | | Constructs a new PrintStream on the file the name of which isfileName .
All writes to the target can now take place through this PrintStream. Its
encoding character set is the default charset in the VM.
Parameters: fileName - the file to provide convenience methods on. throws: FileNotFoundException - if the file does not exist or cannot be opened to write. Orthe file cannot be created or any problem when open the fileto write. throws: SecurityException - if the security manager exists and denies the write to thefile. |
PrintStream | public PrintStream(String fileName, String csn) throws FileNotFoundException, UnsupportedEncodingException(Code) | | Constructs a new PrintStream on the file the name of which isfileName .
All writes to the target can now take place through this PrintStream. Its
encoding character set name is csn .
Parameters: fileName - the file to provide convenience methods on. Parameters: csn - the character set name throws: FileNotFoundException - if the file does not exist or cannot be opened to write. Orthe file cannot be created or any problem when open the fileto write. throws: SecurityException - if the security manager exists and denies the write to thefile. throws: UnsupportedEncodingException - if the chosen character set is not supported |
append | public PrintStream append(char c)(Code) | | Append a char c to the PrintStream. The
PrintStream.append(c ) works the same way as
PrintStream.print(c ).
Parameters: c - The character appended to the PrintStream. The PrintStream. |
append | public PrintStream append(CharSequence csq)(Code) | | Append a CharSequence csq to the PrintStream. The
PrintStream.append(csq ) works the same way as
PrintStream.print(csq .toString()). If csq
is null, then a CharSequence just contains then "null" will be
substituted for csq .
Parameters: csq - The CharSequence appended to the PrintStream. The PrintStream. |
append | public PrintStream append(CharSequence csq, int start, int end)(Code) | | Append a subsequence of a CharSequence csq to the
PrintStream. The first char and the last char of the subsequnce is
specified by the parameter start and end .
The PrintStream.append(csq ) works the same way as
PrintStream.print (csq csq.subSequence(start ,
end ).toString). If csq is null, then
"null" will be substituted for csq .
Parameters: csq - The CharSequence appended to the PrintStream. Parameters: start - The index of the first char in the CharSequence appended tothe PrintStream. Parameters: end - The index of the char after the last one in the CharSequenceappended to the PrintStream. The PrintStream. throws: IndexOutOfBoundsException - If start is less than end, end is greater than the length ofthe CharSequence, or start or end is negative. |
checkError | public boolean checkError()(Code) | | Answers a boolean indicating whether or not this PrintStream has
encountered an error. If so, the receiver should probably be closed since
further writes will not actually take place. A side effect of calling
checkError is that the target OutputStream is flushed.
true if an error occurred in this PrintStream,false otherwise. |
close | public synchronized void close()(Code) | | Close this PrintStream. This implementation flushes and then closes the
target stream. If an error occurs, set an error in this PrintStream to
true .
|
flush | public synchronized void flush()(Code) | | Flush this PrintStream to ensure all pending data is sent out to the
target OutputStream. This implementation flushes the target OutputStream.
If an error occurs, set an error in this PrintStream to true .
|
format | public PrintStream format(String format, Object... args)(Code) | | Writes a string formatted by an intermediate Formatter to
this stream using the given format string and arguments.
The method uses the default for the current JVM instance locale, as if it
is specified by the Locale.getDefault() call.
Parameters: format - A format string. Parameters: args - The arguments list. If there are more arguments than thosespecified by the format string, then the additional argumentsare ignored. This stream. throws: IllegalFormatException - If the format string is illegal or incompatible with thearguments or the arguments are less than those required bythe format string or any other illegal situation. throws: NullPointerException - If the given format is null. |
format | public PrintStream format(Locale l, String format, Object... args)(Code) | | Writes a string formatted by an intermediate Formatter to
this stream using the given format string and arguments.
Parameters: l - The locale used in the method. If locale is null, then nolocalization will be applied. Parameters: format - A format string. Parameters: args - The arguments list. If there are more arguments than thosespecified by the format string, then the additional argumentsare ignored. This stream. throws: IllegalFormatException - If the format string is illegal or incompatible with thearguments or the arguments are less than those required bythe format string or any other illegal situation. throws: NullPointerException - If the given format is null. |
print | public void print(char[] charArray)(Code) | | Prints the String representation of the character array parameter
charArray to the target OutputStream.
Parameters: charArray - the character array to print on this PrintStream. |
print | public void print(char ch)(Code) | | Prints the String representation of the character parameter
ch to the target OutputStream.
Parameters: ch - the character to print on this PrintStream. |
print | public void print(double dnum)(Code) | | Prints the String representation of the double parameter
dnum to the target OutputStream.
Parameters: dnum - the double to print on this PrintStream. |
print | public void print(float fnum)(Code) | | Prints the String representation of the float parameter
fnum to the target OutputStream.
Parameters: fnum - the float to print on this PrintStream. |
print | public void print(int inum)(Code) | | Obtains the int argument as a String and
prints it to the target
OutputStream .
Parameters: inum - the int to print on this PrintStream. |
print | public void print(long lnum)(Code) | | Prints the String representation of the long parameter
lnum to the target OutputStream.
Parameters: lnum - the long to print on this PrintStream. |
print | public void print(Object obj)(Code) | | Prints the String representation of the Object parameter obj
to the target OutputStream.
Parameters: obj - the Object to print on this PrintStream. |
print | public synchronized void print(String str)(Code) | | Prints the String representation of the String parameter
str to the target OutputStream.
Parameters: str - the String to print on this PrintStream. |
print | public void print(boolean bool)(Code) | | Prints the String representation of the boolean parameter
bool to the target OutputStream.
Parameters: bool - the boolean to print on this PrintStream. |
printf | public PrintStream printf(String format, Object... args)(Code) | | Prints a formatted string. The behavior of this method is the same as
this stream's format(String format, Object... args)
method.
The method uses the default for the current JVM instance locale, as if it
is specified by the Locale.getDefault() call.
Parameters: format - A format string. Parameters: args - The arguments list. If there are more arguments than thosespecified by the format string, then the additional argumentsare ignored. This stream. throws: IllegalFormatException - If the format string is illegal or incompatible with thearguments or the arguments are less than those required bythe format string or any other illegal situation. throws: NullPointerException - If the given format is null. |
printf | public PrintStream printf(Locale l, String format, Object... args)(Code) | | Prints a formatted string. The behavior of this method is the same as
this writer's
format(Locale l, String format, Object... args) method.
Parameters: l - The locale used in the method. If locale is null, then nolocalization will be applied. Parameters: format - A format string. Parameters: args - The arguments list. If there are more arguments than thosespecified by the format string, then the additional argumentsare ignored. This stream. throws: IllegalFormatException - If the format string is illegal or incompatible with thearguments or the arguments are less than those required bythe format string or any other illegal situation. throws: NullPointerException - If the given format is null. |
println | public void println()(Code) | | Prints the String representation of the System property
"line.separator" to the target OutputStream.
|
println | public void println(char[] charArray)(Code) | | Prints the String representation of the character array parameter
charArray to the target OutputStream followed by the
System property "line.separator" .
Parameters: charArray - the character array to print on this PrintStream. |
println | public void println(char ch)(Code) | | Prints the String representation of the character parameter
ch to the target OutputStream followed by the System
property "line.separator" .
Parameters: ch - the character to print on this PrintStream. |
println | public void println(double dnum)(Code) | | Prints the String representation of the double parameter
dnum to the target OutputStream followed by the System
property "line.separator" .
Parameters: dnum - the double to print on this PrintStream. |
println | public void println(float fnum)(Code) | | Prints the String representation of the float parameter
fnum to the target OutputStream followed by the System
property "line.separator" .
Parameters: fnum - the float to print on this PrintStream. |
println | public void println(int inum)(Code) | | Obtains the int argument as a String and
prints it to the target
OutputStream followed by the System
property "line.separator" .
Parameters: inum - the int to print on this PrintStream. |
println | public void println(long lnum)(Code) | | Prints the String representation of the long parameter
lnum to the target OutputStream followed by the System
property "line.separator" .
Parameters: lnum - the long to print on this PrintStream. |
println | public void println(Object obj)(Code) | | Prints the String representation of the Object parameter
obj to the target OutputStream followed by the System
property "line.separator" .
Parameters: obj - the Object to print on this PrintStream. |
println | public synchronized void println(String str)(Code) | | Prints the String representation of the String parameter
str to the target OutputStream followed by the System
property "line.separator" .
Parameters: str - the String to print on this PrintStream. |
println | public void println(boolean bool)(Code) | | Prints the String representation of the boolean parameter
bool to the target OutputStream followed by the System
property "line.separator" .
Parameters: bool - the boolean to print on this PrintStream. |
setError | protected void setError()(Code) | | |
write | public void write(byte[] buffer, int offset, int count)(Code) | | Writes count bytes from the byte array
buffer starting at offset to this
PrintStream. This implementation writes the buffer to the
target OutputStream and if this PrintStream is set to autoflush, flushes
it. If an error occurs, set an error in this PrintStream to
true .
Parameters: buffer - the buffer to be written Parameters: offset - offset in buffer to get bytes Parameters: count - number of bytes in buffer to write throws: IndexOutOfBoundsException - If offset or count are outside of bounds. |
write | public synchronized void write(int oneByte)(Code) | | Writes the specified byte oneByte to this PrintStream.
Only the low order byte of oneByte is written. This
implementation writes oneByte to the target OutputStream.
If oneByte is equal to the character '\n'
and this PrintSteam is set to autoflush, the target OutputStream is
flushed.
Parameters: oneByte - the byte to be written |
|
|