| java.lang.Object
 java.io.Writer
java.io.PrintWriter
| PrintWriter | | public class PrintWriter extends Writer (Code) | | Print formatted representations of objects to a text-output stream. This
class implements all of the print methods found in PrintStream. It does not
contain methods for writing raw bytes, for which a program should use
unencoded byte streams.
Unlike the PrintStream class, if automatic flushing is enabled it will
be done only when one of the println() methods is invoked, rather than
whenever a newline character happens to be output. The println() methods
use the platform's own notion of line separator rather than the newline
character.
Methods in this class never throw I/O exceptions. The client may
inquire as to whether any errors have occurred by invoking checkError().
version:
1.24, 02/02/00
author:
Mark Reinhold
since:
JDK1.1 |
| Field Summary | |
| protected Writer | out
The underlying character-output stream of this
PrintWriter. |
| Constructor Summary | |
| public | PrintWriter(Writer out)
Create a new PrintWriter, without automatic line flushing. | | public | PrintWriter(Writer out, boolean autoFlush)
Create a new PrintWriter. | | public | PrintWriter(OutputStream out)
Create a new PrintWriter, without automatic line flushing, from an
existing OutputStream. | | public | PrintWriter(OutputStream out, boolean autoFlush)
Create a new PrintWriter from an existing OutputStream. |
| Method Summary | |
| public boolean | checkError()
Flush the stream if it's not closed 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 a character. | | public void | print(int i)
Print an integer. | | public void | print(long l)
Print a long integer. | | public void | print(float f)
Print a floating-point number. | | public void | print(double d)
Print a double-precision floating-point number. | | public void | print(char s)
Print an array of characters. | | public void | print(String s)
Print a string. | | public void | print(Object obj)
Print an object. | | public void | println()
Terminate the current line by writing the line separator string. | | public void | println(boolean x)
Print a boolean value and then terminate the line. | | public void | println(char x)
Print a character 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 integer and then terminate the line. | | public void | println(float x)
Print a floating-point number and then terminate the line. | | public void | println(double x)
Print a double-precision floating-point number and then terminate the
line. | | public void | println(char x)
Print an array of characters and then terminate the line. | | public void | println(String x)
Print a String and then terminate the line. | | public void | println(Object x)
Print an Object and then terminate the line. | | protected void | setError()
Indicate that an error has occurred. | | public void | write(int c)
Write a single character. | | public void | write(char buf, int off, int len)
Write a portion of an array of characters. | | public void | write(char buf)
Write an array of characters. | | public void | write(String s, int off, int len)
Write a portion of a string. | | public void | write(String s)
Write a string. |
| out | | protected Writer out(Code) | | The underlying character-output stream of this
PrintWriter.
since:
1.2 |
| PrintWriter | | public PrintWriter(Writer out)(Code) | | Create a new PrintWriter, without automatic line flushing.
Parameters:
out - A character-output stream |
| PrintWriter | | public PrintWriter(Writer out, boolean autoFlush)(Code) | | Create a new PrintWriter.
Parameters:
out - A character-output stream
Parameters:
autoFlush - A boolean; if true, the println() methods will flushthe output buffer |
| PrintWriter | | public PrintWriter(OutputStream out, boolean autoFlush)(Code) | | Create a new PrintWriter from an existing OutputStream. This
convenience constructor creates the necessary intermediate
OutputStreamWriter, which will convert characters into bytes using the
default character encoding.
Parameters:
out - An output stream
Parameters:
autoFlush - A boolean; if true, the println() methods will flushthe output buffer
See Also: java.io.OutputStreamWriter.OutputStreamWriter(java.io.OutputStream) |
| checkError | | public boolean checkError()(Code) | | Flush the stream if it's not closed and check its error state.
Errors are cumulative; once the stream encounters an error, this
routine will return true on all successive calls.
True if the print stream has encountered an error, either on theunderlying output stream or during a format conversion. |
| print | | public void print(boolean b)(Code) | | Print a boolean value. The string produced by
java.lang.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
PrintWriter.write(int) method.
Parameters:
b - The boolean to be printed |
| print | | public void print(char c)(Code) | | 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
PrintWriter.write(int) method.
Parameters:
c - The char to be printed |
| print | | public void print(char s)(Code) | | 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
PrintWriter.write(int)
method.
Parameters:
s - The array of chars to be printed
throws:
NullPointerException - If s is null |
| print | | public void print(String s)(Code) | | 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
PrintWriter.write(int) method.
Parameters:
s - The String to be printed |
| println | | public void println()(Code) | | 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(double x)(Code) | | Print a double-precision floating-point number and then terminate the
line. This method behaves as though it invokes
PrintWriter.print(double) and then
PrintWriter.println() .
Parameters:
x - the double value to be printed |
| setError | | protected void setError()(Code) | | Indicate that an error has occurred.
|
| write | | public void write(int c)(Code) | | Write a single character.
Parameters:
c - int specifying a character to be written. |
| write | | public void write(char buf, int off, int len)(Code) | | Write a portion of an array of characters.
Parameters:
buf - Array of characters
Parameters:
off - Offset from which to start writing characters
Parameters:
len - Number of characters to write |
| write | | public void write(char buf)(Code) | | Write an array of characters. This method cannot be inherited from the
Writer class because it must suppress I/O exceptions.
Parameters:
buf - Array of characters to be written |
| write | | public void write(String s, int off, int len)(Code) | | Write a portion of a string.
Parameters:
s - A String
Parameters:
off - Offset from which to start writing characters
Parameters:
len - Number of characters to write |
| write | | public void write(String s)(Code) | | Write a string. This method cannot be inherited from the Writer class
because it must suppress I/O exceptions.
Parameters:
s - String to be written |
|
|